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.

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/gmail
Every 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/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 2
  • getThreadReads one of the CALLER's own Gmail threads in full.

    Arguments

    NameTypeRequired
    threadIdstringYes

    Returns GmailThread

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.gmail.getThread({ threadId: "18f3a6b7c8d9e0f1" });
  • searchThreadsSearches the CALLER's own Gmail threads with Gmail search syntax and returns matching thread rows.

    Arguments

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.gmail.searchThreads({ query: "from:example" });

Use it from code