Skip to main content
Glama
VarunDasharadhi

gmail-mcp

by VarunDasharadhi
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

gmail-mcp

A multi-account Gmail MCP server for Claude Code. Lets Claude search threads, read messages, list labels, and create drafts across one or more Gmail accounts you've authorized, over stdio.

Tools

Tool

Description

search_threads

Search Gmail threads using standard Gmail query syntax (e.g. invoice newer_than:7d -category:promotions). Searches one account or all connected accounts and merges results.

get_message

Fetch the full body and headers of a message by ID.

list_labels

List Gmail labels for one or all connected accounts.

list_accounts

List all Gmail accounts that currently have an authorized token saved.

create_draft

Create a new draft (to, subject, body, optional cc/bcc/threadId) in a specific account. Never sends it.

list_drafts

List drafts for one or all connected accounts.

get_draft

Fetch the full body and headers of a draft by ID.

Scopes: gmail.readonly for all read operations, plus gmail.compose for draft creation. This server cannot edit or delete existing drafts, and it cannot send mail — creating a draft is as far as it goes.

Related MCP server: mcp-gmail

Setup

1. Install dependencies

npm install

2. Get OAuth credentials

  1. Create (or reuse) a project in the Google Cloud Console.

  2. Enable the Gmail API.

  3. Create an OAuth client ID of type Desktop app.

  4. Download the credentials and save them as credentials.json in the project root.

credentials.json and everything under tokens/ are gitignored — never commit them.

3. Authorize one or more Gmail accounts

npm run build
npm run auth -- youraccount@gmail.com

This opens a Google consent screen in your browser and, on approval, saves the resulting token to tokens/youraccount@gmail.com.json. Repeat for each account you want Claude to have access to.

If an account was authorized before draft support was added (scopes changed from gmail.readonly only to gmail.readonly + gmail.compose), re-run npm run auth -- <email> for it — the old token won't have permission to create drafts and Gmail API calls will fail with an insufficient-scope error.

4. Register the server with Claude Code

Point Claude Code at the built server, e.g. in your MCP config:

{
  "mcpServers": {
    "gmail": {
      "command": "node",
      "args": ["<path-to-repo>/dist/index.js"]
    }
  }
}

Development

npm run build   # compile TypeScript to dist/
npm start        # run the compiled server

Project structure

src/
  auth.ts    # one-off OAuth flow: authorizes an account and saves its token
  index.ts   # MCP server: exposes search_threads, get_message, list_labels, list_accounts

Tokens are stored per account in tokens/<email>.json and are loaded on demand from TOKENS_DIR at request time, so accounts can be added or removed without restarting the server.

This server cannot be installed

A
license - permissive license
-
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • gmail-mcp

    fernandezdiegoh
    A
    license
    -
    quality
    D
    maintenance
    A minimal MCP server that enables Claude to search, read, and manage Gmail messages and threads using official Google API libraries. It supports actions like sending emails, creating drafts, replying to threads, and managing labels through secure OAuth2 authentication.
    Last updated
    MIT

  • mcp-gmail

    knowledgeislands
    A
    license
    B
    quality
    F
    maintenance
    MCP server that connects Claude with Gmail to read, send, delete, and manage messages and labels via the Google Gmail API.
    Last updated
    3
    MIT

View all related MCP servers

Related MCP Connectors

  • MCP Emails

    Read, search, send, organize, draft and schedule email across your inboxes from any MCP client.

  • sebastianall1977-gmail-mcp

    Manage Gmail end-to-end: search, read, send, draft, label, and organize threads. Automate workflow…

  • shipmail-mcp

    Shipmail MCP server for AI agent custom-domain email inboxes with REST API and webhooks.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/VarunDasharadhi/gmail-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server