<p align="center">
  <img src="assets/logo.png" alt="Fezola" width="96" height="96">
</p>

<h1 align="center">Fezola: IMAP, Gmail and iCloud MCP server</h1>

<p align="center">
  <b>One MCP connector for every inbox and chat you own.</b><br>
  Gmail, iCloud, OVH, IONOS, Gandi or any IMAP mailbox, plus Google Chat and Telegram, in Claude, ChatGPT, Perplexity, Cursor, VS Code and any MCP client.
</p>

<p align="center">
  <a href="https://app.fezola.com?utm_source=github&utm_medium=readme&utm_campaign=fezola-mcp">Website</a> ·
  <a href="https://app.fezola.com/en/docs?utm_source=github&utm_medium=readme&utm_campaign=fezola-mcp">Documentation</a> ·
  <a href="https://youtu.be/NPiCLqNoL_0">Demo video</a> ·
  <a href="https://app.fezola.com/en/pricing?utm_source=github&utm_medium=readme&utm_campaign=fezola-mcp">Pricing</a>
</p>

<p align="center">
  <a href="https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Fezola&connectorUrl=https%3A%2F%2Fapi.fezola.com%2Fmcp"><img alt="Add to Claude" src="https://img.shields.io/badge/Add_to-Claude-D97757?style=for-the-badge"></a>
  <a href="https://cursor.com/en/install-mcp?name=fezola&config=eyJ1cmwiOiJodHRwczovL2FwaS5mZXpvbGEuY29tL21jcCJ9"><img alt="Add to Cursor" src="https://cursor.com/deeplink/mcp-install-dark.svg" height="28"></a>
  <a href="https://insiders.vscode.dev/redirect/mcp/install?name=fezola&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A//api.fezola.com/mcp%22%7D"><img alt="Install in VS Code" src="https://img.shields.io/badge/Install_in-VS_Code-0098FF?style=for-the-badge&logo=visualstudiocode&logoColor=white"></a>
</p>

<p align="center">
  <a href="https://github.com/Sagargupta16/awesome-mcp-servers"><img alt="Listed in Awesome MCP Servers" src="https://sagargupta.online/awesome-mcp-servers/badge.svg"></a>
</p>

---

Most people have more than one inbox: a personal Gmail, a work address, a custom domain on iCloud, OVH, IONOS, Gandi or Fastmail, a Google Chat, a Telegram. Fezola is a **hosted remote MCP server for email over IMAP** (plus Gmail OAuth, Google Chat and Telegram) that puts all of them behind a single connector, so Claude, ChatGPT or any MCP client can answer "what needs my reply today?" across everything. Drafts land in the inbox that got the mail.

Looking for an **IMAP MCP server** without running one yourself? Add your IMAP host and password (an app password for iCloud or Gmail) once on [fezola.com](https://fezola.com), then connect `https://api.fezola.com/mcp` with OAuth: no Docker, no local process, no credentials in your MCP client config.

[![Fezola demo](assets/demo.jpg)](https://youtu.be/NPiCLqNoL_0)

> This repository holds the public documentation and client configuration for the hosted Fezola service. The server itself is closed source and runs at `https://api.fezola.com/mcp`.

<p align="center">
  <img src="assets/demo-what-needs-reply.gif" alt="Asking an AI assistant what needs a reply: answers from Gmail, OVH, Google Chat and Telegram, each labeled with its account" width="720">
</p>

## Connect

| | |
|---|---|
| **Server URL** | `https://api.fezola.com/mcp` |
| **Transport** | Streamable HTTP |
| **Authentication** | OAuth 2.1 with PKCE and dynamic client registration. You sign in to Fezola and approve the assistant on a consent screen. No API key to copy. |
| **Registry** | Official MCP Registry: `com.fezola.app/fezola` |

First create a free account at [app.fezola.com](https://app.fezola.com?utm_source=github&utm_medium=readme&utm_campaign=fezola-mcp) and add your mailboxes and chats. Then add the connector to your client:

### Claude (claude.ai, Desktop, mobile)

Use the **Add to Claude** button above (it opens the form already filled in), or go to Settings > Connectors > **Add custom connector**, name it `Fezola`, paste `https://api.fezola.com/mcp`, then sign in.

### ChatGPT

In ChatGPT, open Settings > Apps & Connectors > Advanced settings and turn on **Developer mode**. Back in Apps & Connectors, click **Create**, name it `Fezola`, paste `https://api.fezola.com/mcp` and choose **OAuth**. Paid plans only (Plus, Pro, Business), on chatgpt.com.

### Perplexity

Settings > Connectors > **+ Custom connector**, choose **Remote**, name it `Fezola`, paste the URL and choose **OAuth**. Pro and Max plans.

### Claude Code

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

Or as a plugin, from this repository's marketplace:

```bash
/plugin marketplace add mehdis34/fezola-mcp
/plugin install fezola@fezola
```

### Gemini CLI

```bash
gemini extensions install https://github.com/mehdis34/fezola-mcp
```

Then run `/mcp auth fezola` to sign in.

### Cursor

Use the **Add to Cursor** button above, or add it to `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "fezola": { "url": "https://api.fezola.com/mcp" }
  }
}
```

### VS Code

Use the **Install in VS Code** button above, or add it to `.vscode/mcp.json`:

```json
{
  "servers": {
    "fezola": { "type": "http", "url": "https://api.fezola.com/mcp" }
  }
}
```

Any other client that supports remote MCP servers with OAuth works the same way: give it the URL and follow the sign-in.

## What you can ask

- "What needs my reply today?" One briefing across every mailbox, Google Chat and Telegram.
- "Find the OVH invoice from last month." One search over all accounts, attachments included (PDF, Word, images).
- "Summarize the thread with Paul and draft a reply." The draft lands in the mailbox that received the email; you review and send.
- "Archive the newsletters from this week" or "move this to Receipts."

## Tools

| Area | Tools |
|---|---|
| Accounts | `list_accounts`, `test_connection`, `rename_account`, `remove_account`, `get_connect_link`, `get_connection_help` |
| Mail: read | `list_recent`, `search_messages`, `get_message`, `get_thread`, `get_attachment`, `list_folders` |
| Mail: drafts | `create_draft`, `reply_draft`, `forward_draft`, `update_draft`, `list_drafts`, `delete_draft` |
| Mail: organize | `mark_as_read`, `mark_as_unread`, `flag_message`, `move_message`, `archive_message`, `trash_message`, `mark_as_spam` |
| Google Chat (read-only) | `list_chat_spaces`, `list_recent_chat`, `search_chat`, `get_chat_thread` |
| Telegram (read-only) | `list_telegram_chats`, `list_recent_telegram`, `search_telegram`, `get_telegram_chat` |
| Profile and access | `get_profile`, `update_profile`, `list_connected_assistants`, `revoke_assistant` |
| Plan | `get_plan`, `get_upgrade_link`, `get_billing_portal_link`, `list_invoices` |

`send_message` exists but is **off by default**: Fezola saves drafts and you send them yourself. Every tool carries MCP annotations (read-only, destructive, idempotent) so clients can ask for confirmation where it matters.

## Guides

- [Multiple Gmail accounts in Claude](https://app.fezola.com/en/guides/multiple-gmail-accounts-in-claude?utm_source=github&utm_medium=readme&utm_campaign=fezola-mcp)
- [All your inboxes in Claude](https://app.fezola.com/en/guides/all-your-inboxes-in-claude?utm_source=github&utm_medium=readme&utm_campaign=fezola-mcp)
- [IMAP MCP server](https://app.fezola.com/en/guides/imap-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=fezola-mcp)
- [iCloud Mail in Claude](https://app.fezola.com/en/guides/icloud-mail-in-claude?utm_source=github&utm_medium=readme&utm_campaign=fezola-mcp)
- [Yahoo Mail in Claude and ChatGPT](https://app.fezola.com/en/guides/yahoo-mail-in-claude-and-chatgpt?utm_source=github&utm_medium=readme&utm_campaign=fezola-mcp)
- [Google Chat in Claude and ChatGPT](https://app.fezola.com/en/guides/google-chat-in-claude-and-chatgpt?utm_source=github&utm_medium=readme&utm_campaign=fezola-mcp)
- [Telegram in Claude and ChatGPT](https://app.fezola.com/en/guides/telegram-in-claude-and-chatgpt?utm_source=github&utm_medium=readme&utm_campaign=fezola-mcp)
- [Is it safe to connect your email to AI?](https://app.fezola.com/en/guides/is-it-safe-to-connect-email-to-ai?utm_source=github&utm_medium=readme&utm_campaign=fezola-mcp)

## Security and privacy

- Messages are read live when the assistant asks. Fezola does not store your emails or chats.
- Mailbox passwords and OAuth tokens are encrypted at rest and never leave the server.
- Each access token only sees the accounts of the user who approved it. You can revoke any assistant at any time.
- Google Chat and Telegram access is read-only.
- Full details: [privacy policy](https://app.fezola.com/en/privacy?utm_source=github&utm_medium=readme&utm_campaign=fezola-mcp). Vulnerability reports: [security.txt](https://app.fezola.com/.well-known/security.txt).

## Plans

- **Free**: 2 sources.
- **Pro**: up to 20 sources, 9 EUR or USD per month or 90 per year, 7-day free trial.

## Screenshots

| Your sources | The connector | Consent |
|---|---|---|
| ![Sources](assets/app-sources.png) | ![Connector](assets/app-connector.png) | ![Consent](assets/app-consent.png) |

## Support

- Email: [support@fezola.com](mailto:support@fezola.com)
- Issues and feature requests: [open an issue](../../issues) in this repository. Which channel should come next: Outlook, Slack, WhatsApp Business?

## License

The documentation and configuration examples in this repository are under the [MIT License](LICENSE). The Fezola service is proprietary.