drio
Open app

Gmail Server for Model Context Protocol (MCP)

Source

Mirror of

Catalog onlyCatalog onlySTDIO

Overview

This project is a server that integrates with Gmail to enable functionalities such as sending, removing, reading, drafting, and responding to emails through the Model Context Protocol (MCP).

To use this server, set up the Gmail API, authenticate your application, and configure it to work with an MCP client. Follow the setup instructions provided in the documentation.

  • Send emails to specified recipients. - Remove emails by moving them to trash. - Mark emails as read. - Retrieve unread emails. - Read specific email content. - Open emails in a browser.
  1. Automating email responses in applications.
  2. Integrating email functionalities into desktop applications.
  3. Managing email workflows programmatically.

Add to your AI client

Use these steps to connect Gmail Server for Model Context Protocol (MCP) in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "jmonsellier-gmail-mcp-server-mcp-mirror": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-jmonsellier-gmail-mcp-server-mcp-mirror"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "jmonsellier-gmail-mcp-server-mcp-mirror": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-jmonsellier-gmail-mcp-server-mcp-mirror"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "jmonsellier-gmail-mcp-server-mcp-mirror": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-jmonsellier-gmail-mcp-server-mcp-mirror"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "jmonsellier-gmail-mcp-server-mcp-mirror": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-jmonsellier-gmail-mcp-server-mcp-mirror"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "jmonsellier-gmail-mcp-server-mcp-mirror": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-jmonsellier-gmail-mcp-server-mcp-mirror"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "jmonsellier-gmail-mcp-server-mcp-mirror": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-jmonsellier-gmail-mcp-server-mcp-mirror"
      ]
    }
  }
}

FAQ

Can this server send emails on behalf of the user?

Yes, it can send emails after user authentication.

Is there a limit to the number of emails that can be processed?

The limits depend on Gmail's API usage policies.

How do I troubleshoot issues with the server?

Use the MCP Inspector tool for testing and troubleshooting.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":985,"uuid":"14591a37-26fe-4fca-8160-c0c4651ad26a","name":"jmonsellier_gmail-mcp-server","title":"Gmail Server for Model Context Protocol (MCP)","description":"Mirror of","avatar_url":"https://avatars.githubusercontent.com/u/192820360?v=4","created_at":"2025-01-28T02:21:59.171Z","updated_at":"2025-02-23T07:19:16.551Z","status":"created","author_name":"MCP-Mirror","author_avatar_url":"https://avatars.githubusercontent.com/u/192820360?v=4","tags":"gmail,mcp,email-server","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/MCP-Mirror/jmonsellier_gmail-mcp-server","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":null,"user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Developer tools