Gmail

by jasonsum

61 stars
Not rated
GitHub

About

Integrates with Gmail API to enable email operations like sending, managing labels, and searching messages.

Details

Author
jasonsum
Repository
jasonsum/gmail-mcp-server
GitHub stars
61
License
GNU General Public License v3.0
Categories
Productivity, Developer Tools, Design, AI, Search, Frontend, API, Communication
Tags
#integration

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Gmail
    Command (node, npx, python, etc.) uv
    Arguments
    • Argument 1 --directory
    • Argument 2 [absolute-path-to-git-repo]
    • Argument 3 run
    • Argument 4 gmail
    • Argument 5 --creds-file-path
    • Argument 6 [absolute-path-to-credentials-file]
    • Argument 7 --token-path
    • Argument 8 [absolute-path-to-access-tokens-file]

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

send-email

Sends email to email address recipient. Parameters: recipient_id (string), subject (string), message (string). Returns status and message_id.

trash-email

Moves email to trash. Parameters: email_id (string): Auto-generated ID of email. Returns success message.

mark-email-as-read

Marks email as read. Parameters: 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. Parameters: email_id (string): Auto-generated ID of email. Returns dictionary of email metadata and marks email as read.

open-email

Open email in browser. Parameters: email_id (string): Auto-generated ID of email. Returns success message and opens given email in default browser.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "gmail": {
            "cwd": "string",
            "env": {},
            "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]"
            ],
            "shell": false,
            "command": "uv"
        }
    }
}

Linux

{
    "cwd": "string",
    "env": [],
    "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]"
    ],
    "shell": false,
    "command": "uv"
}

Macos

{
    "cwd": "string",
    "env": [],
    "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]"
    ],
    "shell": false,
    "command": "uv"
}

Windows

{
    "cwd": "string",
    "env": [],
    "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]"
    ],
    "shell": false,
    "command": "uv"
}

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.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.