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.
- Site
- mail.aol.com
- Functions
- 14
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
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_mailOne 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/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.
getAccountProfileReads the CALLER's own AOL account page (login.aol.com/myaccount/personalinfo) and returns its server-rendered props verbatim.Arguments
None.
Returns
AolAccountProfileinterface 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/getAccountProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aol_mail.getAccountProfile();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aol_mail.getAccountProfile())curl -X POST https://api.bowmark.ai/v1/sites/aol_mail/getAccountProfile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required credentialsMailboxCredentialsYes idstringA row's id.Yes indexnumberThe attachment's position in getMessage's attachments list, from 0.Yes Returns
AolMailAttachmentinterface 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/getAttachmentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aol_mail.getAttachment({ credentials: {}, id: "<id>", index: 1 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aol_mail.getAttachment({"credentials": {}, "id": "<id>", "index": 1}))curl -X POST https://api.bowmark.ai/v1/sites/aol_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.aol_mail.getAttachment({ credentials: {}, id: "<id>", index: 1 });getMessageReads one of the CALLER's own AOL Mail messages in full.Arguments
Name Type Required credentialsMailboxCredentialsYes idstringA row's id from listMessages / searchMessages.Yes Returns
AolMailMessageinterface 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/getMessageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aol_mail.getMessage({ credentials: {}, id: "<id>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aol_mail.getMessage({"credentials": {}, "id": "<id>"}))curl -X POST https://api.bowmark.ai/v1/sites/aol_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.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
Name Type Required credentialsMailboxCredentialsYes querystringA name or address fragment; omit for the whole address book.No limitnumber1-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/listContactsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aol_mail.listContacts({ credentials: {} });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aol_mail.listContacts({"credentials": {}}))curl -X POST https://api.bowmark.ai/v1/sites/aol_mail/listContacts \ -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.aol_mail.listContacts({ credentials: {} });listFoldersLists the CALLER's own AOL Mail folders.Arguments
Name Type Required 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/listFoldersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aol_mail.listFolders({ credentials: {} });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aol_mail.listFolders({"credentials": {}}))curl -X POST https://api.bowmark.ai/v1/sites/aol_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.aol_mail.listFolders({ credentials: {} });listMessagesLists the newest messages in one of the CALLER's own AOL 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
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/listMessagesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aol_mail.listMessages({ credentials: {} });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aol_mail.listMessages({"credentials": {}}))curl -X POST https://api.bowmark.ai/v1/sites/aol_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.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
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
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/searchMessagesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aol_mail.searchMessages({ credentials: {}, query: "<query>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aol_mail.searchMessages({"credentials": {}, "query": "<query>"}))curl -X POST https://api.bowmark.ai/v1/sites/aol_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.aol_mail.searchMessages({ credentials: {}, query: "<query>" });
createFolderCreates a new folder in the CALLER's own AOL Mail account and returns it in listFolders' shape.Arguments
Name Type Required credentialsMailboxCredentialsYes namestringThe new folder's name, e.g. "Taxes".Yes Returns
AolMailFolderinterface 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/createFolderCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aol_mail.createFolder({ credentials: {}, name: "<name>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aol_mail.createFolder({"credentials": {}, "name": "<name>"}))curl -X POST https://api.bowmark.ai/v1/sites/aol_mail/createFolder \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"credentials":{},"name":"<name>"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required credentialsMailboxCredentialsYes messageIdstringYes Returns
AolMailDeleteResultinterface 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/deleteMessageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aol_mail.deleteMessage({ credentials: {}, messageId: "<messageId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aol_mail.deleteMessage({"credentials": {}, "messageId": "<messageId>"}))curl -X POST https://api.bowmark.ai/v1/sites/aol_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.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
Name Type Required credentialsMailboxCredentialsYes messageIdstringA row's id.Yes flaggedbooleanDefault true (stars it); false unstars it.No Returns
AolMailFlagResultinterface AolMailFlagResult { id: string; flagged: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/aol_mail/flagMessageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aol_mail.flagMessage({ credentials: {}, messageId: "<messageId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aol_mail.flagMessage({"credentials": {}, "messageId": "<messageId>"}))curl -X POST https://api.bowmark.ai/v1/sites/aol_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.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
Name Type Required credentialsMailboxCredentialsYes messageIdstringA row's id.Yes readbooleanDefault true; false marks it unread.No Returns
AolMailReadResultinterface AolMailReadResult { id: string; read: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/aol_mail/markAsReadCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aol_mail.markAsRead({ credentials: {}, messageId: "<messageId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aol_mail.markAsRead({"credentials": {}, "messageId": "<messageId>"}))curl -X POST https://api.bowmark.ai/v1/sites/aol_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.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
Name Type Required credentialsMailboxCredentialsYes messageIdstringYes folderIdstringA folder id from listFolders, or a role word like "archive".Yes Returns
AolMailMoveResultinterface 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/moveMessageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aol_mail.moveMessage({ credentials: {}, messageId: "<messageId>", folderId: "<folderId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aol_mail.moveMessage({ "credentials": {}, "messageId": "<messageId>", "folderId": "<folderId>" }))curl -X POST https://api.bowmark.ai/v1/sites/aol_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.aol_mail.moveMessage({ credentials: {}, messageId: "<messageId>", folderId: "<folderId>" });sendMessageSends an email from the CALLER's own AOL Mail account.Arguments
Name Type Required tostringYes subjectstringYes bodystringYes fromstringNo Returns
AolMailSendResultinterface 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/sendMessageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aol_mail.sendMessage({ to: "<to>", subject: "<subject>", body: "<body>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aol_mail.sendMessage({"to": "<to>", "subject": "<subject>", "body": "<body>"}))curl -X POST https://api.bowmark.ai/v1/sites/aol_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.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
Name Type Required firstNamestringAt least one of the two.No lastNamestringNo Returns
AolProfileUpdateResultinterface 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/updateAccountProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aol_mail.updateAccountProfile({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aol_mail.updateAccountProfile({}))curl -X POST https://api.bowmark.ai/v1/sites/aol_mail/updateAccountProfile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.aol_mail.updateAccountProfile({});
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/aol_mail/<function> - OpenAPI
/v1/sites/aol_mail/openapi.json