Yahoo Mail MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on Yahoo Mail: 10 typed functions through one MCP server. No Yahoo Mail API key needed.
- Site
- mail.yahoo.com
- Functions
- 10
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Yahoo Mail alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/yahoo_mailOne MCP server for Yahoo Mail and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.
Functions
Open a function to see its arguments, what it returns and how to call it.
getAttachmentSaves one attachment of the CALLER's own Yahoo Mail message to the run's files, given the message's row id and the attachment's position in…Arguments
Name Type Required credentialsMailboxCredentialsYes idstringA row's id.Yes indexnumberThe attachment's position in getMessage's attachments list, from 0.Yes Returns
YahooMailAttachmentinterface YahooMailAttachment { id: string; index: number; filename: string | null; contentType: string; sizeBytes: number; // decoded file?: { id: string; name: string; contentType: string; bytes: number; url: string; expiresAt: string }; // saved to the run's files; absent when the run has no account warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_mail/getAttachmentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_mail.getAttachment({ credentials: {}, id: "<id>", index: 1 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_mail.getAttachment({"credentials": {}, "id": "<id>", "index": 1}))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_mail/getAttachment \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"credentials":{},"id":"<id>","index":1}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_mail.getAttachment({ credentials: {}, id: "<id>", index: 1 });getMessageReads one of the CALLER's own Yahoo Mail messages in full.Arguments
Name Type Required credentialsMailboxCredentialsYes idstringA row's id from listMessages / searchMessages.Yes Returns
YahooMailMessageinterface YahooMailMessage { id: string; folder: string; from: string; to: string[]; cc: string[]; subject: string; sentAt: string | null; // the message's own Date: header receivedAt: string; // ISO 8601 unread: boolean; flagged: boolean; messageId: string | null; // RFC 5322 Message-ID, for threading, not the id other functions take body: string | null; // the text/plain part bodyHtml: string | null; attachments: { filename: string | null; contentType: string; size: number }[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_mail/getMessageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_mail.getMessage({ credentials: {}, id: "<id>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_mail.getMessage({"credentials": {}, "id": "<id>"}))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_mail/getMessage \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"credentials":{},"id":"<id>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_mail.getMessage({ credentials: {}, id: "<id>" });listFoldersLists the CALLER's own Yahoo Mail folders.Arguments
Name Type Required credentialsMailboxCredentialsYes Returns
YahooMailFolder[]interface YahooMailFolder { id: string; // pass as folderId; INBOX is "INBOX" name: string; specialUse: string | null; // "\\Sent", "\\Trash", "\\Junk", "\\Drafts", "\\Archive" or null totalCount?: number; unreadCount?: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_mail/listFoldersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_mail.listFolders({ credentials: {} });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_mail.listFolders({"credentials": {}}))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_mail/listFolders \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"credentials":{}}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_mail.listFolders({ credentials: {} });listMessagesLists the newest messages in one of the CALLER's own Yahoo Mail folders (Inbox by default), newest first.Arguments
Name Type Required credentialsMailboxCredentialsYes folderIdstringA folder id from listFolders, or "sent" / "trash" / "spam" / "drafts" / "archive"; default INBOX.No limitnumberNewest N, 1-100, default 25.No Returns
YahooMailMessageRow[]interface YahooMailMessageRow { id: string; // "<folder>:<uidValidity>:<uid>", pass it to getMessage / markAsRead / moveMessage / deleteMessage as-is folder: string; from: string; // "Name <address>" subject: string; snippet: string; receivedAt: string; // ISO 8601 unread: boolean; flagged: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_mail/listMessagesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_mail.listMessages({ credentials: {} });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_mail.listMessages({"credentials": {}}))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_mail/listMessages \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"credentials":{}}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_mail.listMessages({ credentials: {} });searchMessagesSearches the CALLER's own Yahoo Mail by sender, recipient, subject, read/flagged state and text, in one folder or every folder except Trash and Spam.Arguments
Name Type Required credentialsMailboxCredentialsYes querystringFrom:, to:, cc:, subject:, is:unread, is:read, is:flagged, and plain words.Yes folderIdstringOmit to search every folder except Trash and Spam.No limitnumber1-100, default 25.No Returns
YahooMailMessageRow[]interface YahooMailMessageRow { id: string; // "<folder>:<uidValidity>:<uid>", pass it to getMessage / markAsRead / moveMessage / deleteMessage as-is folder: string; from: string; // "Name <address>" subject: string; snippet: string; receivedAt: string; // ISO 8601 unread: boolean; flagged: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_mail/searchMessagesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_mail.searchMessages({ credentials: {}, query: "<query>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_mail.searchMessages({"credentials": {}, "query": "<query>"}))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_mail/searchMessages \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"credentials":{},"query":"<query>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_mail.searchMessages({ credentials: {}, query: "<query>" });
deleteMessageDeletes one of the CALLER's own Yahoo Mail messages the way the site's own delete button does: to Trash, or for good when it is already in Trash.Arguments
Name Type Required credentialsMailboxCredentialsYes messageIdstringYes Returns
YahooMailDeleteResultinterface YahooMailDeleteResult { deleted: "to-trash" | "permanently"; // permanently only when it was already in Trash, like the site's own button id: string | null; // its new id in Trash, when moved there folder: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_mail/deleteMessageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_mail.deleteMessage({ credentials: {}, messageId: "<messageId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_mail.deleteMessage({"credentials": {}, "messageId": "<messageId>"}))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_mail/deleteMessage \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"credentials":{},"messageId":"<messageId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_mail.deleteMessage({ credentials: {}, messageId: "<messageId>" });flagMessageStars (flags) one of the CALLER's own Yahoo Mail messages, or unstars it, given a row id from listMessages or searchMessages.Arguments
Name Type Required credentialsMailboxCredentialsYes messageIdstringA row's id.Yes flaggedbooleanDefault true (stars it); false unstars it.No Returns
YahooMailFlagResultinterface YahooMailFlagResult { id: string; flagged: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_mail/flagMessageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_mail.flagMessage({ credentials: {}, messageId: "<messageId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_mail.flagMessage({"credentials": {}, "messageId": "<messageId>"}))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_mail/flagMessage \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"credentials":{},"messageId":"<messageId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_mail.flagMessage({ credentials: {}, messageId: "<messageId>" });markAsReadMarks one of the CALLER's own Yahoo Mail messages read or unread, given a row id from listMessages or searchMessages.Arguments
Name Type Required credentialsMailboxCredentialsYes messageIdstringA row's id.Yes readbooleanDefault true; false marks it unread.No Returns
YahooMailReadResultinterface YahooMailReadResult { id: string; read: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_mail/markAsReadCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_mail.markAsRead({ credentials: {}, messageId: "<messageId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_mail.markAsRead({"credentials": {}, "messageId": "<messageId>"}))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_mail/markAsRead \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"credentials":{},"messageId":"<messageId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_mail.markAsRead({ credentials: {}, messageId: "<messageId>" });moveMessageMoves one of the CALLER's own Yahoo Mail messages to another folder (archive, spam, trash, a custom folder) and returns its new id there.Arguments
Name Type Required credentialsMailboxCredentialsYes messageIdstringYes folderIdstringA folder id from listFolders, or a role word like "archive".Yes Returns
YahooMailMoveResultinterface YahooMailMoveResult { id: string | null; // the message's NEW id in the destination folder (null if the server did not say) folder: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_mail/moveMessageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_mail.moveMessage({ credentials: {}, messageId: "<messageId>", folderId: "<folderId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_mail.moveMessage({ "credentials": {}, "messageId": "<messageId>", "folderId": "<folderId>" }))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_mail/moveMessage \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"credentials":{},"messageId":"<messageId>","folderId":"<folderId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_mail.moveMessage({ credentials: {}, messageId: "<messageId>", folderId: "<folderId>" });sendMessageSends an email from the CALLER's own Yahoo Mail account.Arguments
Name Type Required tostringYes subjectstringYes bodystringYes fromstringNo Returns
YahooMailSendResultinterface YahooMailSendResult { accepted: boolean; raw: Record<string, unknown>; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yahoo_mail/sendMessageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yahoo_mail.sendMessage({ to: "<to>", subject: "<subject>", body: "<body>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yahoo_mail.sendMessage({"to": "<to>", "subject": "<subject>", "body": "<body>"}))curl -X POST https://api.bowmark.ai/v1/sites/yahoo_mail/sendMessage \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"to":"<to>","subject":"<subject>","body":"<body>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yahoo_mail.sendMessage({ to: "<to>", subject: "<subject>", body: "<body>" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/yahoo_mail/<function> - OpenAPI
/v1/sites/yahoo_mail/openapi.json