Mailspring

Access your yahoo.fr (Yahoo! Mail) email via MCP

Let AI assistants like Claude Desktop, ChatGPT and Claude Code read, search, organize and reply to your Yahoo email — all from your own computer, with no cloud connector and no sharing your password with a third party.

Last Verified September 2026

Give your AI assistant access to your Yahoo inbox

MCP (Model Context Protocol) is an open standard that lets AI assistants connect to the apps and data you already use. When an app exposes an "MCP server", assistants like Claude and ChatGPT can call it to look things up and take actions on your behalf.

yahoo.fr (Yahoo! Mail) doesn't offer an MCP server of its own, but it supports IMAP, which means you can use an email program like Mailspring to sync your Yahoo mailbox to your computer. Mailspring includes a built-in MCP server that runs locally, so any MCP-compatible assistant on your machine can work with your Yahoo email.

Follow these steps to connect your Yahoo account to your AI assistant:

Step 1: Download Mailspring

Mailspring is a free desktop email application with a built-in MCP server for AI assistants. It works on Mac, Linux, and Windows.

Download Mailspring Free

Step 2: Sign in to your Yahoo account

Run Mailspring and choose IMAP / SMTP on the email setup screen. Enter the connection settings for your Yahoo account and click "Continue". Mailspring is a full email client and syncs your yahoo.fr (Yahoo! Mail) email to your computer, which is what makes it available to your AI assistant. Your email should be displayed in a few minutes.

Step 3: Enable the MCP server

Open Preferences in Mailspring and click the MCP Server tab. Flip the Enable MCP Server switch on — you'll see a green "Running" badge when it's ready. The server is off by default and only listens on your own computer (127.0.0.1), so nothing is exposed to your network or the internet.

The MCP Server tab in Mailspring's preferences

From this screen you can also choose an Access Level that controls what your assistant is allowed to do:

Read Only (default) — search and read mail, but never change anything
Read & Write — also create drafts, archive, star, label and move threads
Read, Write & Send — also send drafts and schedule messages to send later

Under Account Access, you can limit which accounts and folders are visible to the assistant, so it can see your Yahoo inbox but not, say, a personal account or a confidential folder.

Step 4: Add Mailspring to your AI assistant

The Quick Setup buttons write the connection details into each app's config file for you. Click the one for the assistant you use — that's all you need to do! Restart the assistant and start a new chat, and Mailspring will appear as a connected tool.

Claude Desktop Registers Mailspring in Claude Desktop's config. No Node.js or extra installs needed.

ChatGPT Desktop Adds Mailspring to the ChatGPT desktop app so it can search and work with your mail.

Claude Code Runs claude mcp add so Claude Code can work with your email from the terminal.

Using something else, like Cursor, VS Code or another MCP-compatible tool? Mailspring's server uses the standard Streamable HTTP transport, so any MCP client can connect to it. Copy the Endpoint and Bearer Token shown in the Connection panel into your client's MCP settings. For most clients that means a JSON entry like this:

{
  "mcpServers": {
    "mailspring": {
      "url": "http://127.0.0.1:2587/mcp",
      "headers": {
        "Authorization": "Bearer <your token from the MCP Server tab>"
      }
    }
  }
}

Step 5: Try it out

Open a new chat in your assistant and ask it about your Yahoo email. Try prompts like:

"Read the threads in my inbox using Mailspring — what should I prioritize? Draft a reply to the most important message."
"Find the invoice PDF that Yahoo sent me last month and tell me the total."
"Summarize everything from my accountant this week and archive the threads I don't need to act on."
"Which of the emails I sent this month have been opened? Which links got the most clicks?"

Every call the assistant makes is recorded in the Activity Log at the bottom of the MCP Server tab, so you can always see exactly what it looked at and what it changed.

What can your assistant do with Yahoo email?

Mailspring's MCP server exposes a focused set of tools. The Access Level you choose in Step 3 determines which groups are available:

Read & search	`search_mail` `list_threads` `get_thread` `get_message` `get_attachment` `list_folders` `list_accounts` Search with Gmail-style queries like from:alice is:unread has:attachment since:"last week", read full threads, and view attachments.
Insights	`get_message_tracking` `list_tracked_messages` `get_top_links` `list_scheduled_sends` See which sent messages were opened, which links were clicked, and what's queued to send later.
Organize & draft	`create_draft` `reply_to_thread` `archive_threads` `trash_threads` `move_to_folder` `set_labels` `set_unread` `set_starred` `cancel_scheduled_send` Requires Read & Write. Drafts are saved in Mailspring for you to review — nothing is sent.
Send	`send_draft` `schedule_send` Requires Read, Write & Send. Send a draft now or schedule it for later, just like the composer's "Send Later" button.

Your Yahoo email stays on your computer

Unlike cloud email integrations, Mailspring never uploads your Yahoo mailbox to a third-party service to make it available to AI. The MCP server runs inside the Mailspring app on your machine, listens only on localhost, and requires a secret bearer token that you can regenerate at any time. Combined with the access level, per-account and per-folder controls, and the activity log, you stay in charge of what your assistant can see and do.