Build for free
How to connect Claude to your email with MCP

How to connect Claude to your email with MCP

• 8 min read
Jump to section
Author: Tanisha Kumar
Tanisha Kumar
Tags:
Jump to section

Claude has built-in connectors for Gmail and Microsoft 365, but nothing for Yahoo, iCloud, Exchange, or other IMAP mailboxes, and each connector covers one provider. An email MCP server (MCP is the Model Context Protocol) fills that gap. The server supplies the tools, and Claude calls them. This post covers the setup with the Nylas MCP server, which reaches six provider types through one connection, what Claude can do once connected, and how to keep a human in the loop.

Can Claude connect to Yahoo Mail or iCloud?

Yes. Neither provider offers a first-party Claude integration, but the MCP server handles the provider connection and Claude only sees tools such as “list emails” and “send email.” One setup covers every supported provider, so you do not wire up Gmail, Outlook, and Yahoo separately.

What is MCP and why does Claude use it?

MCP is an open standard, introduced by Anthropic in November 2024, for connecting AI assistants to external tools and data. A server advertises a set of tools, and the assistant decides when to call them. Claude Desktop, Claude Code, Cursor, and other MCP clients all work this way, as described at modelcontextprotocol.io. Because the model is decoupled from each integration, adding email to Claude is a configuration step, not a code change.

How do I set up the Nylas MCP server for Claude?

You need the Nylas CLI and a Nylas account (nylas init can create a free one). Configure the CLI, connect an account, install the MCP configuration, then restart Claude. On a fresh install, nylas auth login fails with “nylas not configured” until you run nylas init, so start there.

  1. Run nylas init to configure the CLI.
  2. Connect an account with nylas auth login --provider google. Repeat for each provider you want, for example --provider yahoo.
  3. Install the MCP configuration with nylas mcp install --assistant claude-desktop (use --assistant claude-code for Claude Code).
  4. Restart Claude.
  5. Verify with nylas mcp status.
# 1. Configure the CLI once
nylas init

# 2. Connect an account once (repeat per provider you want)
nylas auth login --provider google
nylas auth login --provider yahoo

# 3. Add the Nylas MCP server to Claude Desktop (or claude-code)
nylas mcp install --assistant claude-desktop

# 4. Restart Claude, then confirm the server is registered
nylas mcp status

The configuration it writes looks like this:

{
  "mcpServers": {
    "nylas": {
      "command": "nylas",
      "args": ["mcp", "serve"]
    }
  }
}

The same command supports claude-code, cursor, windsurf, and vscode, so the email tools follow you across editors. Use --all to configure every detected assistant at once. The config points the assistant at nylas mcp serve, which proxies to the Nylas MCP server using credentials stored locally. If you prefer to edit the config by hand, it is a single mcpServers block.

Which email providers can Claude reach through Nylas MCP?

The CLI supports six provider values at login:

ProviderLogin flagHow you sign inClaude via Nylas MCP
Gmail / Google--provider googleBrowser OAuth flowYes
Outlook / Microsoft 365--provider microsoftBrowser OAuth flowYes
Yahoo Mail--provider yahooApp passwordYes
iCloud Mail--provider icloudApp-specific passwordYes
Exchange / EWS--provider ewsBrowser OAuth flowYes
Any IMAP server--provider imapUsername, password, host, and portYes

What can Claude do with my email once connected?

Claude can list and search the inbox, read message bodies, send mail, and read the calendar. Try prompts like these:

  • “Summarize my unread email from [sender] since Monday.”
  • “Draft a reply to the latest message from [sender]. Do not send it.”
  • “Find a 30-minute slot on Thursday afternoon when I’m free.”

Because Claude acts on your live account, treat sending as a sensitive action. The Nylas MCP server requires a confirmation call (confirm_send_message or confirm_send_draft) before any send. That confirmation is a call the agent makes, so on its own it is not a human approval, and whether it is shown to you depends on your client. Pair it with the human-in-the-loop steps below.

Tip for large mailboxes: long message lists and big email bodies use up Claude’s context window. Ask for a date range, folder, or search query to keep responses focused.

How do I keep a human in the loop?

  • Have Claude draft into a review queue instead of sending unattended.
  • Treat email bodies as untrusted input. A message can contain instructions aimed at the assistant, which is prompt injection.
  • Start with read-only use on one mailbox before enabling send.

The MCP email security checklist and the guide on stopping an AI agent going rogue cover the guardrails in more detail.

When should I use the Email API instead of the MCP server?

The CLI route fits one person and one mailbox. A product that lets many users connect their own inboxes needs the same normalized email and calendar data behind an API, with per-user authorization and webhooks for new mail. That is the job of the Nylas Email API, which sits on the same communications data layer the MCP server uses.

Frequently asked questions

Does Claude have a built-in Gmail or Outlook connector?

Yes, for Gmail and Microsoft 365. For Yahoo, iCloud, Exchange, or IMAP mailboxes, or to reach several accounts from one setup, add an email MCP server such as the Nylas MCP server. It supplies tools for listing, reading, and sending messages, and Claude calls them when you ask.

Can Claude send email through MCP, and is it safe?

Yes, once send is enabled. Treat it as a sensitive action. The Nylas MCP server requires a confirmation call before any send, but whether you see it depends on your client. Start read-only, have Claude draft instead of send, and treat email bodies as untrusted input.

How do I prevent prompt injection when Claude reads my email?

Treat every email body as untrusted input, because a message can carry hidden instructions aimed at the assistant. Start with read-only access on one mailbox, have Claude draft into a review queue instead of sending, and keep the send confirmation call in place. See the MCP email security checklist.

Which email providers work with the Nylas MCP server?

Gmail, Outlook and Microsoft 365, Yahoo Mail, iCloud Mail, Exchange (EWS), and any IMAP server. You connect each account once with nylas auth login and a provider flag.

How do I connect Claude Code instead of Claude Desktop?

Run nylas mcp install --assistant claude-code, restart, and check nylas mcp status. The same command also supports cursor, windsurf, and vscode, or use --all to configure every detected assistant.

Why can’t Claude see my Nylas tools after setup?

Restart Claude after running nylas mcp install, then run nylas mcp status to confirm the server is registered. If nylas auth login failed earlier, run nylas init first, then connect an account again.

Next steps

Run nylas init, then nylas mcp install --assistant claude-desktop, and ask Claude to summarize your unread mail.

Sources

Related resources

Email API Nylas CLI
How to list IMAP emails from the terminal

Every IMAP server needs its own hostname, port, TLS mode, and authentication method, and getting…

• 6 min read
Read more
CLI Email API Google
Gmail SMTP Settings: Server, Ports, App Passwords, and OAuth

Gmail’s outgoing server is smtp.gmail.com. It accepts connections on port 587 with STARTTLS and port…

• 7 min read
Read more
CLI Email API Nylas MCP
How to choose an email CLI: inbox access, delivery, or SMTP testing

Disclosure: Nylas publishes this post and builds the Nylas CLI. We cover where it fits…

• 5 min read
Read more