AOL Mail MCP server for AI agents

Let Claude, ChatGPT or your own agent read and act on AOL Mail: 14 typed functions through one MCP server. No AOL Mail API key needed.

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

Connect

Just AOL Mail

An MCP server for AOL 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/aol_mail
Every site

One MCP server for AOL 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 7
  • getAccountProfileReads the CALLER's own AOL account page (login.aol.com/myaccount/personalinfo) and returns its server-rendered props verbatim.

    Arguments

    None.

    Returns AolAccountProfile

    interface AolAccountProfile {
      url: string; // https://login.aol.com/myaccount/personalinfo
      ctx: { sessionIndex?: string; acrumb?: string; crumb?: string; locale?: string } | null; // the page's own crumbs
      components: object[]; // every client-component props object the page server-rendered, verbatim, field names UNMEASURED signed in
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/aol_mail/getAccountProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aol_mail.getAccountProfile();
  • getAttachmentSaves one attachment of the CALLER's own AOL 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 AolMailAttachment

    interface AolMailAttachment {
      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/aol_mail/getAttachment

    Call it

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

    Arguments

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

    Returns AolMailMessage

    interface AolMailMessage {
      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/aol_mail/getMessage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aol_mail.getMessage({ credentials: {}, id: "<id>" });
  • listContactsLooks up contacts in the CALLER's own AOL address book over CardDAV, optionally filtered by a name or address fragment.

    Arguments

    NameTypeRequired
    credentialsMailboxCredentialsYes
    querystring
    A name or address fragment; omit for the whole address book.
    No
    limitnumber
    1-500, default 100.
    No

    Returns AolMailContact[]

    interface AolMailContact {
      id: string; // the vCard's href on carddav.aol.com
      name: string | null;
      emails: string[]; // pass one as sendMessage's to
      phones: string[];
      organization: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/aol_mail/listContacts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aol_mail.listContacts({ credentials: {} });
  • listFoldersLists the CALLER's own AOL Mail folders.

    Arguments

    NameTypeRequired
    credentialsMailboxCredentialsYes

    Returns AolMailFolder[]

    interface AolMailFolder {
      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/aol_mail/listFolders

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aol_mail.listFolders({ credentials: {} });
  • listMessagesLists the newest messages in one of the CALLER's own AOL 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 AolMailMessageRow[]

    interface AolMailMessageRow {
      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/aol_mail/listMessages

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aol_mail.listMessages({ credentials: {} });
  • searchMessagesSearches the CALLER's own AOL 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 AolMailMessageRow[]

    interface AolMailMessageRow {
      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/aol_mail/searchMessages

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aol_mail.searchMessages({ credentials: {}, query: "<query>" });
Act 7
  • createFolderCreates a new folder in the CALLER's own AOL Mail account and returns it in listFolders' shape.

    Arguments

    NameTypeRequired
    credentialsMailboxCredentialsYes
    namestring
    The new folder's name, e.g. "Taxes".
    Yes

    Returns AolMailFolder

    interface AolMailFolder {
      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/aol_mail/createFolder

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aol_mail.createFolder({ credentials: {}, name: "<name>" });
  • deleteMessageDeletes one of the CALLER's own AOL 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 AolMailDeleteResult

    interface AolMailDeleteResult {
      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/aol_mail/deleteMessage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aol_mail.deleteMessage({ credentials: {}, messageId: "<messageId>" });
  • flagMessageStars (flags) one of the CALLER's own AOL 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 AolMailFlagResult

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

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aol_mail.flagMessage({ credentials: {}, messageId: "<messageId>" });
  • markAsReadMarks one of the CALLER's own AOL 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 AolMailReadResult

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

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aol_mail.markAsRead({ credentials: {}, messageId: "<messageId>" });
  • moveMessageMoves one of the CALLER's own AOL 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 AolMailMoveResult

    interface AolMailMoveResult {
      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/aol_mail/moveMessage

    Call it

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

    Arguments

    NameTypeRequired
    tostringYes
    subjectstringYes
    bodystringYes
    fromstringNo

    Returns AolMailSendResult

    interface AolMailSendResult {
      accepted: boolean; // the gateway returned 2xx; does NOT confirm the recipient received anything, "Save" vs "Send" is unconfirmed, see sendMessage's own doc comment
      raw: object;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aol_mail.sendMessage({ to: "<to>", subject: "<subject>", body: "<body>" });
  • updateAccountProfileChanges the first and/or last name on the CALLER's own AOL account by filling the account page's name fields and pressing Save in a browser, through…

    Arguments

    NameTypeRequired
    firstNamestring
    At least one of the two.
    No
    lastNamestringNo

    Returns AolProfileUpdateResult

    interface AolProfileUpdateResult {
      saved: boolean; // the page's save request answered 2xx
      status: number | null; // that request's HTTP status
      saveUrl: string | null; // that request's URL
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/aol_mail/updateAccountProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aol_mail.updateAccountProfile({});

Use it from code