Skip to main content
Glama

mcp-google

MCP server for Google APIs — Gmail and Calendar tools for LLM agents.

Install

# Run directly with uvx (no install needed)
uvx mcp-google

# Or install with pip
pip install mcp-google

Related MCP server: gg-mcp

Environment Variables

Variable

Description

GOOGLE_CLIENT_ID

OAuth2 client ID from Google Cloud Console

GOOGLE_CLIENT_SECRET

OAuth2 client secret

GOOGLE_ACCOUNTS_JSON

JSON array of account configs (see below)

GOOGLE_ACCOUNTS_JSON format

[
  {"email": "personal@gmail.com", "refresh_token": "1//..."},
  {"email": "work@company.com", "refresh_token": "1//..."}
]

The first account in the array is used as default when no account parameter is specified.

Tools

Phase 1 — Read-only

Tool

Parameters

Description

gmail_list_unread

account?, max_results?

List unread emails (subject, sender, date, snippet)

gmail_get_message

message_id, account?

Get full email content by ID

calendar_today

account?

Today's events

calendar_week

account?

This week's agenda

Phase 2 — Write

Tool

Parameters

Description

gmail_send

to, subject, body, account?

Send an email

calendar_create_event

title, start, end, account?

Create a calendar event

OAuth Setup

  1. Go to Google Cloud Console

  2. Create a project (or select existing)

  3. Enable Gmail API and Google Calendar API

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

    • Application type: Desktop app

    • Note the Client ID and Client Secret

  5. Configure OAuth consent screen with required scopes:

    • https://www.googleapis.com/auth/gmail.readonly

    • https://www.googleapis.com/auth/gmail.send

    • https://www.googleapis.com/auth/calendar.readonly

    • https://www.googleapis.com/auth/calendar.events

  6. Obtain refresh tokens for each account using the OAuth2 flow

  7. Set environment variables (copy .env.example to .env and fill in values)

Obtaining Refresh Tokens

Use the Google OAuth Playground or run a local OAuth flow:

# Quick method via oauth2l
pip install google-auth-oauthlib
python -c "
from google_auth_oauthlib.flow import InstalledAppFlow
flow = InstalledAppFlow.from_client_config(
    {'installed': {'client_id': 'YOUR_CLIENT_ID', 'client_secret': 'YOUR_SECRET', 'auth_uri': 'https://accounts.google.com/o/oauth2/auth', 'token_uri': 'https://oauth2.googleapis.com/token'}},
    scopes=['https://www.googleapis.com/auth/gmail.readonly', 'https://www.googleapis.com/auth/gmail.send', 'https://www.googleapis.com/auth/calendar.readonly', 'https://www.googleapis.com/auth/calendar.events']
)
creds = flow.run_local_server(port=0)
print(f'Refresh token: {creds.refresh_token}')
"

Running

# As MCP server (stdio transport)
mcp-google

# Or directly
python -m mcp_google.server

Claude Desktop config

{
  "mcpServers": {
    "google": {
      "command": "mcp-google",
      "env": {
        "GOOGLE_CLIENT_ID": "...",
        "GOOGLE_CLIENT_SECRET": "...",
        "GOOGLE_ACCOUNTS_JSON": "[{\"email\": \"me@gmail.com\", \"refresh_token\": \"...\"}]"
      }
    }
  }
}

License

MIT

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

Maintenance

Maintainers
1dResponse time
Release cycle
1Releases (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

  • A
    license
    B
    quality
    D
    maintenance
    A local MCP server that provides LLM clients with read/write access to email and calendar data from Gmail, iCloud, and generic IMAP providers. It runs entirely on your machine, keeping data private while enabling email management, calendar operations, and task handling through natural language.
    Last updated
    39
    MIT
  • A
    license
    -
    quality
    A
    maintenance
    Local MCP server for reading/sending email via Gmail and managing Google Calendar events, enabling an AI agent to handle email and calendar operations through natural language.
    Last updated
    1
    MIT

View all related MCP servers

Related MCP Connectors

  • Hosted Google Calendar MCP server for AI agents. No self-hosting or Google Cloud setup.

  • A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…

  • Phone, SMS & email for AI agents — one remote MCP endpoint, OAuth login, zero install.

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/antonio-mello-ai/mcp-google'

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