Skip to main content
Glama
Sign In
enesjakozh

Gmail MCP Server

by jasonsum
GitHub
Python
GPL 3.0
17
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Enables sending, reading, trashing, and managing emails through Gmail. Provides tools for retrieving unread emails, viewing email content, marking emails as read, sending new emails, and opening emails in a browser.

  • Uses Google Cloud for authentication and API access to Gmail services through OAuth credentials and token management.

Gmail Server for Model Context Protocol (MCP)

This MCP server integrates with Gmail to enable sending, removing, reading, drafting, and responding to emails.

Note: This server enables an MCP client to read, remove, and send emails. However, the client prompts the user before conducting such activities.

https://github.com/user-attachments/assets/5794cd16-00d2-45a2-884a-8ba0c3a90c90

Components

Tools

  • send-email
    • Sends email to email address recipient
    • Input:
      • recipient_id (string): Email address of addressee
      • subject (string): Email subject
      • message (string): Email content
    • Returns status and message_id
  • trash-email
    • Moves email to trash
    • Input:
      • email_id (string): Auto-generated ID of email
    • Returns success message
  • mark-email-as-read
    • Marks email as read
    • Input:
      • email_id (string): Auto-generated ID of email
    • Returns success message
  • get-unread-emails
    • Retrieves unread emails
    • Returns list of emails including email ID
  • read-email
    • Retrieves given email content
    • Input:
      • email_id (string): Auto-generated ID of email
    • Returns dictionary of email metadata and marks email as read
  • open-email
    • Open email in browser
    • Input:
      • email_id (string): Auto-generated ID of email
    • Returns success message and opens given email in default browser

Setup

Gmail API Setup

  1. Create a new Google Cloud project
  2. Enable the Gmail API
  3. Configure an OAuth consent screen
    • Select "external". However, we will not publish the app.
    • Add your personal email address as a "Test user".
  4. Add OAuth scope https://www.googleapis.com/auth/gmail/modify
  5. Create an OAuth Client ID for application type "Desktop App"
  6. Download the JSON file of your client's OAuth keys
  7. Rename the key file and save it to your local machine in a secure location. Take note of the location.
    • The absolute path to this file will be passed as parameter --creds-file-path when the server is started.

Authentication

When the server is started, an authentication flow will be launched in your system browser. Token credentials will be subsequently saved (and later retrieved) in the absolute file path passed to parameter --token-path.

For example, you may use a dot directory in your home folder, replacing [your-home-folder].:

ParameterExample
--creds-file-path/[your-home-folder]/.google/client_creds.json
--token-path/[your-home-folder]/.google/app_tokens.json

Usage with Desktop App

Using uv is recommended.

To integrate this server with Claude Desktop as the MCP Client, add the following to your app's server configuration. By default, this is stored as ~/Library/Application\ Support/Claude/claude_desktop_config.json.

{ "mcpServers": { "gdrive": { "command": "uv", "args": [ "--directory", "[absolute-path-to-git-repo]", "run", "gmail", "--creds-file-path", "[absolute-path-to-credentials-file]", "--token-path", "[absolute-path-to-access-tokens-file]" ] } } }

The following parameters must be set

ParameterExample
--directoryAbsolute path to gmail directory containing server
--creds-file-pathAbsolute path to credentials file created in Gmail API Setup.
--token-pathAbsolute path to store and retrieve access and refresh tokens for application.

Troubleshooting with MCP Inspector

To test the server, use MCP Inspector. From the git repo, run the below changing the parameter arguments accordingly.

npx @modelcontextprotocol/inspector uv run [absolute-path-to-git-repo]/src/gmail/server.py --creds-file-path [absolute-path-to-credentials-file] --token-path [absolute-path-to-access-tokens-file]

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

MCP server that integrates with Gmail to enable sending, reading, and managing emails through tools like send-email, trash-email, get-unread-emails, and read-email.

  1. Components
    1. Tools
  2. Setup
    1. Gmail API Setup
    2. Authentication
    3. Usage with Desktop App
    4. Troubleshooting with MCP Inspector

Related Resources

Related MCP Servers

  • Gmail MCP Server

    jmonsellier
    -
    security
    A
    license
    -
    quality
    Integrates with Gmail to enable sending, reading, drafting, and managing emails via the Model Context Protocol (MCP), allowing users to interact with email tasks through automated client prompts.
    Last updated -
    Python
    GPL 3.0

  • Email Sending MCP

    resend
    A
    security
    F
    license
    A
    quality
    A simple MCP server that enables users to send emails using Resend's API, integrating with tools like Cursor and Claude Desktop for seamless email composition and delivery.
    Last updated -
    1
    6
    321
    TypeScript
    • Apple

  • Email sending MCP

    Deploya-labs
    -
    security
    F
    license
    -
    quality
    An MCP server that allows Claude Desktop or Cursor to send emails directly using Resend's API, eliminating the need to copy-paste email content.
    Last updated -
    6
    TypeScript

  • AWS SES MCP

    omd01
    -
    security
    A
    license
    -
    quality
    An MCP server that enables sending emails directly through AWS SES without copy-pasting, supporting plain text and HTML emails with features like CC, BCC, and reply-to functionality.
    Last updated -
    TypeScript
    MIT License
    • Linux
    • Apple

View all related MCP servers

Appeared in Searches

New MCP Servers

ID: ghsycs61i7