Skip to main content
Glama
gmail-mcp

gmail-mcp

by edarrington

Gmail MCP Server

MCP server for Gmail integration with Claude Code.

Setup

1. Create Google Cloud Credentials

  1. Go to Google Cloud Console

  2. Create a new project (or select existing)

  3. Enable the Gmail API

  4. Go to Credentials → Create Credentials → OAuth 2.0 Client ID

  5. Application type: Desktop app

  6. Download the JSON file

  7. Rename to credentials.json and place in this folder

2. Install Dependencies

cd D:\Projects\gmail-mcp
pip install -r requirements.txt

3. First-time Authentication

Run once to authorize:

python server.py

This will open a browser for OAuth consent. After authorizing, a token.json file is created.

4. Add to Claude Code

Add to your MCP settings (%APPDATA%\Claude\claude_desktop_config.json or VS Code settings):

{
  "mcpServers": {
    "gmail": {
      "command": "python",
      "args": ["D:\\Projects\\gmail-mcp\\server.py"]
    }
  }
}

Related MCP server: Gmail MCP Server

Tools

Tool

Description

get_todays_emails

Get all emails from today

get_emails

Get emails with optional search query

get_email

Get full email by ID

search_emails

Advanced email search

mark_as_read

Mark emails as read

send_email

Send an email

get_labels

List Gmail labels

Security

Do not commit these files:

  • credentials.json - OAuth client credentials

  • token.json - Your auth token

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables reading, sending, searching, and managing Gmail through Claude using the official Google Gmail API.
      3
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables Claude to read and manage your Gmail account, including listing, searching, sending, drafting, replying to, archiving, labeling, and trashing emails via the Gmail API.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Connects Claude Code to Gmail for reading, searching, drafting, and managing emails with features like labels, filters, and smart workflows.
      MIT