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.

Functions
10
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just Yahoo Mail

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_mail
Every site

One 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/mcp
Set it up in your client

Both 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.

Read 5
  • 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

    NameTypeRequired
    credentialsMailboxCredentialsYes
    idstring
    A row's id.
    Yes
    indexnumber
    The attachment's position in getMessage's attachments list, from 0.
    Yes

    Returns YahooMailAttachment

    interface 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/getAttachment

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_mail.getAttachment({ credentials: {}, id: "<id>", index: 1 });
  • getMessageReads one of the CALLER's own Yahoo Mail messages in full.

    Arguments

    NameTypeRequired
    credentialsMailboxCredentialsYes
    idstring
    A row's id from listMessages / searchMessages.
    Yes

    Returns YahooMailMessage

    interface 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/getMessage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_mail.getMessage({ credentials: {}, id: "<id>" });
  • listFoldersLists the CALLER's own Yahoo Mail folders.

    Arguments

    NameTypeRequired
    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/listFolders

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    credentialsMailboxCredentialsYes
    folderIdstring
    A folder id from listFolders, or "sent" / "trash" / "spam" / "drafts" / "archive"; default INBOX.
    No
    limitnumber
    Newest 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/listMessages

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    credentialsMailboxCredentialsYes
    querystring
    From:, to:, cc:, subject:, is:unread, is:read, is:flagged, and plain words.
    Yes
    folderIdstring
    Omit to search every folder except Trash and Spam.
    No
    limitnumber
    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/searchMessages

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_mail.searchMessages({ credentials: {}, query: "<query>" });
Act 5
  • 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

    NameTypeRequired
    credentialsMailboxCredentialsYes
    messageIdstringYes

    Returns YahooMailDeleteResult

    interface 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/deleteMessage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    credentialsMailboxCredentialsYes
    messageIdstring
    A row's id.
    Yes
    flaggedboolean
    Default true (stars it); false unstars it.
    No

    Returns YahooMailFlagResult

    interface YahooMailFlagResult {
      id: string;
      flagged: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/yahoo_mail/flagMessage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    credentialsMailboxCredentialsYes
    messageIdstring
    A row's id.
    Yes
    readboolean
    Default true; false marks it unread.
    No

    Returns YahooMailReadResult

    interface YahooMailReadResult {
      id: string;
      read: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/yahoo_mail/markAsRead

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    credentialsMailboxCredentialsYes
    messageIdstringYes
    folderIdstring
    A folder id from listFolders, or a role word like "archive".
    Yes

    Returns YahooMailMoveResult

    interface 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/moveMessage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_mail.moveMessage({
      credentials: {},
      messageId: "<messageId>",
      folderId: "<folderId>"
    });
  • sendMessageSends an email from the CALLER's own Yahoo Mail account.

    Arguments

    NameTypeRequired
    tostringYes
    subjectstringYes
    bodystringYes
    fromstringNo

    Returns YahooMailSendResult

    interface YahooMailSendResult {
      accepted: boolean;
      raw: Record<string, unknown>;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/yahoo_mail/sendMessage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_mail.sendMessage({ to: "<to>", subject: "<subject>", body: "<body>" });

Use it from code