# get_inbox_emails (/docs/mcp/tools/get-inbox-emails)

{/* Generated by scripts/sync-mcp-tools.mjs from happierleads-api. Do not edit: change src/routes/mcp/toolDocs.json there, or add content/mcp-notes/get_inbox_emails.mdx. */}

**List outreach inbox** · Read-only

List prospects from the outreach master inbox of a website across all campaigns, most recent activity first. Default status inbox shows prospects who replied (including out-of-office) and are not archived. Use get_email_thread to read one conversation, reply_to_prospect to answer and archive_email to clear it. websiteId comes from list_websites. Returns prospects[] (each with _id, recipientEmail, firstName, lastName, status, the sending emailAccount, emailCampaign and emails[]; each emails[].emailId is the emailId the other inbox tools take), totalProspects, currentPage and totalPages.

| Connection | Account URL, team member URL or OAuth |
| --- | --- |

## Parameters [#parameters]

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `websiteId` | `string` | Yes | Website id from list_websites. |
| `status` | `string` | No | Which view to list: inbox (replied, not archived; default), contacted (an email was sent), scheduled (an email is due and not sent yet) or archived. |
| `page` | `number` | No | Page number, starting at 1. Default 1. |
| `limit` | `number` | No | Prospects per page. Default 20. |
| `searchQuery` | `string` | No | Optional case-insensitive text matched against first name, last name and email address. |

## Tool definition [#tool-definition]

What your assistant receives from `tools/list`:

```json
{
  "name": "get_inbox_emails",
  "title": "List outreach inbox",
  "annotations": {
    "title": "List outreach inbox",
    "readOnlyHint": true,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "websiteId": {
        "type": "string",
        "description": "Website id from list_websites."
      },
      "status": {
        "type": "string",
        "description": "Which view to list: inbox (replied, not archived; default), contacted (an email was sent), scheduled (an email is due and not sent yet) or archived."
      },
      "page": {
        "type": "number",
        "description": "Page number, starting at 1. Default 1."
      },
      "limit": {
        "type": "number",
        "description": "Prospects per page. Default 20."
      },
      "searchQuery": {
        "type": "string",
        "description": "Optional case-insensitive text matched against first name, last name and email address."
      }
    },
    "required": [
      "websiteId"
    ]
  }
}
```