Gmail MCP server for AI agents
Let Claude, ChatGPT or your own agent read Gmail: 2 typed functions through one MCP server. No Gmail API key needed.
- Site
- mail.google.com
- Functions
- 2
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
Just Gmail
An MCP server for Gmail 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/gmailEvery site
One MCP server for Gmail 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.
Read 2
getThreadReads one of the CALLER's own Gmail threads in full.Arguments
Name Type Required threadIdstringYes Returns
GmailThreadinterface GmailThreadMessage { from: string | null; to: string[]; date: string | null; body: string | null } interface GmailThread { id: string; subject: string | null; messages: GmailThreadMessage[] }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/gmail/getThreadCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.gmail.getThread({ threadId: "18f3a6b7c8d9e0f1" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.gmail.getThread({"threadId": "18f3a6b7c8d9e0f1"}))curl -X POST https://api.bowmark.ai/v1/sites/gmail/getThread \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"threadId":"18f3a6b7c8d9e0f1"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.gmail.getThread({ threadId: "18f3a6b7c8d9e0f1" });searchThreadsSearches the CALLER's own Gmail threads with Gmail search syntax and returns matching thread rows.Arguments
Name Type Required querystringYes limitnumberNo Returns
GmailThreadRow[]interface GmailThreadRow { id: string; from: string | null; subject: string | null; snippet: string | null; date: string | null; unread: boolean }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/gmail/searchThreadsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.gmail.searchThreads({ query: "from:example" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.gmail.searchThreads({"query": "from:example"}))curl -X POST https://api.bowmark.ai/v1/sites/gmail/searchThreads \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"from:example"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.gmail.searchThreads({ query: "from:example" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/gmail/<function> - OpenAPI
/v1/sites/gmail/openapi.json