Skip to main content

A Python MCP server for Gmail and Google Calendar integration with Claude Desktop

Project description

Gmail MCP Server Gmail MCP Server is a Python package that integrates Gmail and Google Calendar with Claude Desktop. It allows users to summarize emails, send emails, and automatically create calendar events for important emails using an MCP server. Features

Summarize recent emails in your Gmail inbox. Send emails directly from Claude Desktop. Create Google Calendar events manually or automatically for emails labeled as "important". Runs as a background server with a 10-minute scheduler for automatic event creation.

Installation pip install gmail-mcp-server

Setup

Enable Gmail and Google Calendar APIs in Google Cloud Console. Download credentials.json and place it in ~/.gmail_mcp_server/ (Windows: C:\Users<Username>.gmail_mcp_server). Install the package and run the server:pip install gmail-mcp-server gmail-mcp-server

Usage with Claude Desktop Configure Claude Desktop by adding the following to claude_desktop_config.json (e.g., C:\Users<Username>\AppData\Roaming\Claude\claude_desktop_config.json): { "mcpServers": { "email-mcp-server": { "command": "gmail-mcp-server", "args": [], "cwd": "" } } }

Example commands:

Summarize emails: Summarize the last 3 emails in my inbox. Send email: Send an email to example@gmail.com with subject "Test" and body "Hello". Create calendar event: Create a calendar event for the last important email.

Automatic Calendar Events

Emails labeled "important" in Gmail are automatically processed every 10 minutes. A calendar event is created, and the email is tagged with calendar_event_created.

Dependencies

google-api-python-client google-auth-oauthlib mcp schedule

License MIT Support For issues, visit GitHub Issues or email fakeloginpage13@gmail.com.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gmail_mcp_server-0.1.1.tar.gz (5.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

gmail_mcp_server-0.1.1-py3-none-any.whl (6.2 kB view details)

Uploaded Python 3

File details

Details for the file gmail_mcp_server-0.1.1.tar.gz.

File metadata

  • Download URL: gmail_mcp_server-0.1.1.tar.gz
  • Upload date:
  • Size: 5.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.0

File hashes

Hashes for gmail_mcp_server-0.1.1.tar.gz
Algorithm Hash digest
SHA256 83b41975544e5199b6f1b3187f6eb93920e67c3b71c0383665f039e9129e93a3
MD5 80b2f408415d57c7c2231eeb38f210eb
BLAKE2b-256 d8f24013829981a00fd0fca6963df96ce3770c40743ab064cea1d49d178b6c2c

See more details on using hashes here.

File details

Details for the file gmail_mcp_server-0.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for gmail_mcp_server-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 1a0706a730270aca61668e79e6644c8c03310fdeb3569e2aeccd2cca9501c172
MD5 19e8105a01a2b1f7d067700d55743b7d
BLAKE2b-256 d2e4eacb81061b34599d69ec36209ce1e90a262c523afbd5b2b9f7b586666d71

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page