# Connect Claude

> Give Claude access to your mailbox via MCP.

Faivelo ships a hosted MCP (Model Context Protocol) server, so you can connect Claude directly to your mailboxes — read, search, send, and tidy up your mail by just asking. Setup takes about a minute, and there are no API keys to copy around: you sign in, pick exactly which mailboxes Claude may touch, and approve.

You need an active paid Faivelo plan to use the connection.

## Connect claude.ai

1. In [claude.ai](https://claude.ai), open **Settings → Connectors**.
2. Click **Add custom connector** and paste:
```text
https://faivelo.com/api/mcp
```
3. Your browser opens the Faivelo sign-in page — log in if you aren't already.
4. On the consent screen, choose which of your mailboxes Claude may access. Only the mailboxes you tick are reachable — everything else on your account stays invisible.
5. Optionally tick **Allow creating new mailboxes** if you want Claude to be able to provision new addresses on your domains (capped at 10 per day; new mailboxes it creates are added to the connection automatically).
6. Click **Approve**. That's it — no keys to copy, nothing to paste back.

## Connect Claude Code

One command:

```bash
claude mcp add --transport http faivelo https://faivelo.com/api/mcp
```

The first time Claude Code uses the connector, it opens the same Faivelo sign-in and mailbox picker in your browser.

## What Claude can do

Once connected, Claude gets a full mail toolset — scoped to the mailboxes you selected:

<table>
<thead>
  <tr>
    <th>
      Ability
    </th>
    
    <th>
      Tools
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      Get oriented
    </td>
    
    <td>
      <code>
        list_mailboxes
      </code>
      
      , <code>
        list_domains
      </code>
      
      , <code>
        get_account_summary
      </code>
      
       (send quota used/remaining), <code>
        get_setup_summary
      </code>
      
       (a shareable summary of what is set up)
    </td>
  </tr>
  
  <tr>
    <td>
      Read mail
    </td>
    
    <td>
      <code>
        list_messages
      </code>
      
      , <code>
        read_message
      </code>
      
      , <code>
        get_thread
      </code>
      
       (whole conversations), <code>
        search_messages
      </code>
      
      , <code>
        search_all_mailboxes
      </code>
      
       (one query across every shared mailbox), <code>
        list_folders
      </code>
      
      , <code>
        get_attachment
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      Look up contacts
    </td>
    
    <td>
      <code>
        get_contacts
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      Send mail
    </td>
    
    <td>
      <code>
        send_message
      </code>
      
       — supports attachments and a <code>
        sendAt
      </code>
      
       time; counts against your plan's send allowance
    </td>
  </tr>
  
  <tr>
    <td>
      Drafts and scheduled sends
    </td>
    
    <td>
      <code>
        create_draft
      </code>
      
      , <code>
        update_draft
      </code>
      
      , <code>
        send_draft
      </code>
      
       (leave a reply in Drafts for you to check first), <code>
        list_scheduled
      </code>
      
      , <code>
        cancel_scheduled
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      Manage messages
    </td>
    
    <td>
      <code>
        flag_message
      </code>
      
      , <code>
        label_message
      </code>
      
      , <code>
        mark_all_read
      </code>
      
      , <code>
        move_message
      </code>
      
      , <code>
        restore_message
      </code>
      
      , <code>
        mark_spam
      </code>
      
      , <code>
        delete_message
      </code>
      
      , <code>
        empty_trash
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      Manage aliases
    </td>
    
    <td>
      <code>
        list_aliases
      </code>
      
      , <code>
        create_alias
      </code>
      
      , <code>
        delete_alias
      </code>
      
       — aliases may only route to the mailboxes you shared
    </td>
  </tr>
  
  <tr>
    <td>
      Check deliverability
    </td>
    
    <td>
      <code>
        get_delivery_status
      </code>
      
       — did mail to a recipient bounce, are they suppressed?
    </td>
  </tr>
  
  <tr>
    <td>
      Browse Drive
    </td>
    
    <td>
      <code>
        drive_list_files
      </code>
      
      , <code>
        drive_download_file
      </code>
      
       — only appear if you granted Drive access during consent
    </td>
  </tr>
  
  <tr>
    <td>
      Create mailboxes
    </td>
    
    <td>
      <code>
        create_mailbox
      </code>
      
       — only appears if you opted in during consent
    </td>
  </tr>
  
  <tr>
    <td>
      Manage DNS
    </td>
    
    <td>
      <code>
        list_dns_records
      </code>
      
      , <code>
        create_dns_record
      </code>
      
      , <code>
        update_dns_record
      </code>
      
      , <code>
        delete_dns_record
      </code>
      
       — API keys with the <code>
        dns:read
      </code>
      
       / <code>
        dns:write
      </code>
      
       scopes only, not Claude connections
    </td>
  </tr>
</tbody>
</table>

<docs-aside type="note" title="Connected before these tools existed?">

Connections made before the toolset expanded won't have alias permissions. Disconnect and reconnect the Faivelo connector to pick up the full set.

</docs-aside>

## Things to try

- "Summarize my unread mail."
- "Find the invoice from Acme and reply that payment is on the way."
- "Search support@ for anything mentioning refunds this week and give me a rundown."
- "Move all the newsletters in my inbox to the Newsletters folder."

## Managing and revoking access

Every connection is listed in your Faivelo dashboard under **Settings → Connected Apps**. You can see what each app can reach and revoke it with one click — revoking cuts access instantly.

## Security

- **You choose the blast radius.** Claude can only reach the mailboxes you picked on the consent screen — never your other mailboxes, domains, billing, or account settings.
- **Tokens expire and rotate.** Access tokens are short-lived (one hour) and refreshed automatically with rotating refresh tokens. If a rotated token is ever replayed, the whole connection is revoked as a precaution.
- **Everything is revocable.** Remove the connection from Settings → Connected Apps at any time, and access stops immediately.

<docs-aside type="note">

Sending through the connector uses your plan's normal monthly send allowance, and message actions (delete, move, mark spam) are real — Claude asks before doing anything destructive, but the changes it makes are the same as if you'd made them in webmail.

</docs-aside>

## Next steps

- Building a headless agent instead? See [AI agents & API keys](/developers/ai-agents) for scoped API keys and the same MCP server with Bearer auth.