Gmail Manager

Gmail Manager MCP gives you direct access to your Gmail inbox through the Model Context Protocol, letting you search, read, label, and bulk-manage emails from an MCP client. It streamlines common inbox tasks and enables automated workflows with MCP-ready commands.

How to use

You integrate Gmail Manager MCP with your MCP client to perform actions on your Gmail inbox. Start by authenticating, then use the available tools to search emails, read full content, create and apply labels, and delete or organize messages. Typical workflows include finding emails by sender or subject, labeling incoming messages automatically, and removing old newsletters or spam in bulk.

How to install

Prerequisites you need before installing: Node.js and npm (or npx). Ensure you have internet access and permissions to install global npm packages.

# Install the Gmail Manager MCP globally
npm i -g @spark-apps/gmail-manager-mcp

Additional setup notes

Prepare authentication for Gmail access by generating OAuth credentials and saving the key file as gcp-oauth.keys.json. You will reference this file during authentication to grant the MCP access to your Gmail account.

Configure your MCP client to launch the Gmail Manager MCP as a server. The following example shows how to define the server in your MCP client configuration. Use your own paths and adjust as needed.

{
  "mcpServers": {
    "gmail-manager": {
      "command": "npx", "args": ["@spark-apps/gmail-manager-mcp@latest"],
      "env": { "GMAIL_OAUTH_PATH": "C:\\path\\to\\gcp-oauth.keys.json" }
    }
  }
}

Troubleshooting and tips

If authentication fails, verify that your gcp-oauth.keys.json is accessible at the specified path and that the Gmail API scopes include mail.google.com. Ensure the Google account you test with is listed in Test users for your OAuth client.

If the MCP client cannot reach the Gmail Manager MCP, check network access and that the local server process started correctly. Review any error messages shown by the client launcher for hints about missing environment variables or misconfigured paths.

Available tools

Authenticate Gmail access

Open a browser to authorize Gmail access and obtain OAuth credentials for the MCP to interact with your Gmail account.

Search emails

Query your Gmail inbox using sender, subject, date, or Gmail search syntax to locate relevant messages.

Read email content

Retrieve and display the full content of a selected email.

Create draft reply

Generate a draft reply to a selected email with context-aware content.

List labels

List all labels currently available in your Gmail account.

Create label

Create a new Gmail label for organizing messages.

Apply label

Apply a label to a single email to categorize it.

Apply labels to multiple

Apply one or more labels to a batch of emails in a single operation.

Remove label

Remove a label from a specific email.

Delete label

Permanently delete a Gmail label.

Delete email

Permanently delete a single email from your inbox.

Delete multiple emails

Permanently delete multiple selected emails in one action.