> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bizzyco.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Email Address Tools

> Inspect organization email addresses available for sending and receiving

The Bizzy MCP server provides 2 tools for inspecting the email addresses
connected to your organization. Use these tools to discover which addresses are
available for sending templated emails or to look up a specific address by ID.

## getEmailAddress

Get details of a specific email address by ID.

**Permission:** `email-addresses:read`

**Parameters:**

| Name             | Type          | Required | Description                             |
| ---------------- | ------------- | -------- | --------------------------------------- |
| `emailAddressId` | string (UUID) | Yes      | The ID of the email address to retrieve |

**Returns:** The email address object, or `null` if not found.

***

## listEmailAddresses

List email addresses for the organization with optional filtering.

**Permission:** `email-addresses:read`

**Parameters:**

| Name       | Type   | Required | Default | Description                                                                                         |
| ---------- | ------ | -------- | ------- | --------------------------------------------------------------------------------------------------- |
| `limit`    | number | No       | 100     | Maximum number of results                                                                           |
| `offset`   | number | No       | 0       | Offset for pagination                                                                               |
| `provider` | string | No       | -       | Filter by email provider. Valid values: `google`, `microsoft`, `bizzy`, `apple`                     |
| `status`   | string | No       | -       | Filter by email address status. Valid values: `pending`, `active`, `disabled`, `errored`, `deleted` |

**Returns:**

```json theme={null}
{
  "emailAddresses": [...],
  "count": 12,
  "limit": 100,
  "offset": 0
}
```

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Email Template Tools" icon="envelope-open-text" href="/mcp-server/tools/email-templates">
    Create, render, and send templated emails
  </Card>

  <Card title="Authentication" icon="key" href="/mcp-server/authentication">
    Learn how MCP clients authenticate to the server
  </Card>
</CardGroup>