How do I install the gmailmcpserver mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`, `STORAGE_PATH` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

GmailMcpServer MCP Server

MCP server for Gmail integration with email categorization, search, archive, and delete capabilities

Local serverstdioTypeScript

What is the GmailMcpServer MCP Server?

MCP server for Gmail integration with email categorization, search, archive, and delete capabilities

What you get

A comprehensive Model Context Protocol (MCP) server that integrates with Gmail API to provide intelligent email management capabilities. Features advanced email categorization, search, archiving, deletion, and automated cleanup with 25+ MCP tools for complete email lifecycle management.

Configuration and credentials

Node.js 18+ and npm - Google Cloud Platform account with Gmail API enabled - OAuth2 credentials (Client ID and Client Secret)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
authenticate
list_emails
get_email_details
categorize_emails	Analyze and categorize emails by importance using AI algorithms.
search_emails	Advanced multi-criteria email search with intelligent filtering.
save_search
list_saved_searches
archive_emails
restore_emails
create_archive_rule
list_archive_rules
export_emails	Export emails to external formats with cloud upload support.
delete_emails	⚠️ Safety Note: Always use dry_run: true first to preview deletions

How to install the GmailMcpServer MCP Server

{
  "mcpServers": {
    "gmail": {
      "command": "node",
      "args": [
        "/path/to/gmail-mcp-server/build/index.js"
      ],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Node.js 18+ and npm - Google Cloud Platform account with Gmail API enabled - OAuth2 credentials (Client ID and Client Secret)

Variable	Description	Required
NODE_ENV	Declared in the maintainer’s client configuration.	Check documentation

Example prompts to try

“Use GmailMcpServer to Prerequisites.”
“Use GmailMcpServer to authenticate.”
“Use GmailMcpServer to list emails.”

Frequently asked questions

MCP server for Gmail integration with email categorization, search, archive, and delete capabilities Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.