MCP Gmail

Provides Gmail access via MCP, enabling search, read, compose, reply, forward, draft management, labels, and attachments.

typescript

2

GitHub Stars

typescript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "ustikya-mcp-gmail": {
      "command": "bun",
      "args": [
        "/ABSOLUTE/PATH/TO/mcp-gmail/src/index.ts"
      ]
    }
  }
}

You can connect Claude to Gmail through an MCP server to perform common email tasks directly from Claude, such as searching, reading, composing, replying, forwarding, and organizing messages and attachments.

How to use

To use this MCP server, you expose Gmail capabilities to Claude. You can perform practical actions like searching your inbox with Gmail operators, drafting replies, archiving or trashing messages, applying or removing labels, and handling attachments. Claude can then request these actions through the MCP interface, and the server executes them against your Gmail account.

How to install

Prerequisites You need Bun runtime installed and a Google account with Gmail.

Clone the project and install dependencies.

git clone https://github.com/user/mcp-gmail.git  # replace with your repo URL
cd mcp-gmail
bun install

Authenticate with Google to obtain OAuth tokens. The flow opens a browser to grant access and saves the tokens locally.
Add the MCP server to Claude Desktop. Create or edit your Claude desktop configuration to register the Gmail MCP server using Bun and the local script path.

{
  "mcpServers": {
    "gmail": {
      "command": "bun",
      "args": ["/ABSOLUTE/PATH/TO/mcp-gmail/src/index.ts"]
    }
  }
}

Run and connect

Start the MCP locally and connect Claude Desktop to the Gmail MCP server. If Bun is not in your PATH, use the full path to the Bun executable.

Available tools

search_emails

Search emails using Gmail query syntax to filter results based on sender, recipient, subject, labels, date ranges, and more.

get_email

Retrieve the full content of a message by its ID, including headers and body.

send_email

Send a new email with specified recipients, subject, body, and attachments.

reply_to_email

Reply to a message while preserving the original thread and context.

forward_email

Forward a message to new recipients, optionally adding comments.

create_draft

Create a new draft message that you can review or modify before sending.

list_drafts

List all saved drafts for easy access and management.

send_draft

Send an existing draft that you previously saved.

delete_draft

Permanently delete a draft from your account.

trash_email

Move a message to the trash.

archive_email

Remove a message from the inbox without deleting it.

mark_as_read

Mark a message as read.

mark_as_unread

Mark a message as unread to indicate it requires attention.

list_labels

List all labels currently defined in your Gmail account.

create_label

Create a new label for organizing messages.

apply_label

Apply a label to a specific message.

remove_label

Remove a label from a specific message.

get_attachment

Download an attachment from a message, returned in base64 encoding.