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

Security

Do not commit these files:

• credentials.json - OAuth client credentials

• token.json - Your auth token