MCP Server

Active

MIT

com.pulsemcp/gmail MCP Server

com.pulsemcp/gmail

Gmail integration for personal and Google Workspace accounts with OAuth2 and service account support.

What is the com.pulsemcp/gmail MCP server?

The Gmail MCP server provides access to Gmail accounts for both personal users (via OAuth2) and Google Workspace organizations (via service account). It enables AI agents to read, search, and manage emails directly within MCP-powered workflows.

This server integrates Gmail into your MCP client, allowing you to access email, search messages, and manage your inbox programmatically. It supports both personal Gmail accounts through OAuth2 authentication and Google Workspace accounts through service account credentials, making it suitable for individual users and enterprise deployments.

How to install com.pulsemcp/gmail

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

GMAIL_OAUTH_CLIENT_ID
secret
OAuth2 client ID from Google Cloud Console (for personal Gmail accounts).
GMAIL_OAUTH_CLIENT_SECRET
secret
OAuth2 client secret from Google Cloud Console.
GMAIL_OAUTH_REFRESH_TOKEN
secret
Refresh token from the OAuth2 setup script.
GMAIL_SERVICE_ACCOUNT_CLIENT_EMAIL
Service account email address (for Google Workspace).
GMAIL_SERVICE_ACCOUNT_PRIVATE_KEY
secret
Service account private key in PEM format (for Google Workspace).
GMAIL_IMPERSONATE_EMAIL
Email address to impersonate (required for service account mode).
GMAIL_ENABLED_TOOLGROUPS
Comma-separated list of tool groups to enable (readonly, readwrite, readwrite_external).

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "-y",
        "gmail-workspace-mcp-server",
        "-y"
      ],
      "env": {
        "GMAIL_OAUTH_CLIENT_ID": "<YOUR_GMAIL_OAUTH_CLIENT_ID>",
        "GMAIL_OAUTH_CLIENT_SECRET": "<YOUR_GMAIL_OAUTH_CLIENT_SECRET>",
        "GMAIL_OAUTH_REFRESH_TOKEN": "<YOUR_GMAIL_OAUTH_REFRESH_TOKEN>",
        "GMAIL_SERVICE_ACCOUNT_CLIENT_EMAIL": "<YOUR_GMAIL_SERVICE_ACCOUNT_CLIENT_EMAIL>",
        "GMAIL_SERVICE_ACCOUNT_PRIVATE_KEY": "<YOUR_GMAIL_SERVICE_ACCOUNT_PRIVATE_KEY>",
        "GMAIL_IMPERSONATE_EMAIL": "<YOUR_GMAIL_IMPERSONATE_EMAIL>",
        "GMAIL_ENABLED_TOOLGROUPS": "<YOUR_GMAIL_ENABLED_TOOLGROUPS>"
      }
    }
  }
}

Use cases

Search and retrieve emails based on queries and filters
Read and analyze email content and attachments
Manage Gmail labels and organize messages
Automate email-based workflows and notifications
Integrate email data into AI agent decision-making processes

com.pulsemcp/gmail MCP server FAQ

What is the Gmail MCP server?

The Gmail MCP server provides MCP clients like Claude and Cursor with access to Gmail accounts. It supports both personal Gmail (via OAuth2) and Google Workspace accounts (via service account authentication).

Is this server officially affiliated with Google?

No, this is an unofficial MCP server created by PulseMCP and is not officially affiliated with Google or Gmail.

How do I install it in Cursor or Claude?

Install via npm using the package name `gmail-workspace-mcp-server`. Configure authentication using either OAuth2 credentials (personal) or a Google service account JSON file (Workspace).

What authentication methods are supported?

The server supports OAuth2 for personal Gmail accounts and service account authentication for Google Workspace organizations.

Is it free to use?

The server itself is free, but you must have a Gmail or Google Workspace account. API usage is subject to Google's Gmail API quotas.

What can I do with this server?

You can search emails, read message content, manage labels, and automate email workflows through your MCP client.

README (reference)

Source of truth, from the repository.

PulseMCP's MCP Servers

We build reliable servers thoughtfully designed for MCP Client-powered workflows.

Design principles

You can have confidence that any Pulse-branded MCP server was built with these north stars in mind:

Purpose-built. LLM-powered MCP clients offer uniquely new user interaction patterns that necessitate a different layer of abstraction than the REST API's from a pre-AI era. We thoughtfully scope drawing lines like building a new server, versus incorporating a new feature in another server. Or deciding where one slew of REST API endpoints might be better packaged as a single Tool call. And more.
Easy set up. Many MCP servers die before ever getting a chance to be used. We offer guides and a frustration-free experience to get going with our MCP servers inside your favorite MCP clients.
Time savings. By minimizing the number of tool chain steps or conversational turns you need to accomplish a task, our MCP servers will save you (and your agents) time waiting for a task to be completed.
Inference cost savings. By minimizing the number of tokens you need to consume to a accomplish a task, our MCP servers will save you on your LLM inference bills.
Reliability. You should have confidence that you can deploy our servers in a production application serving mass market consumers or business clients.
Future-proof. We sit on the bleeding edge of the MCP specification, working to push the ecosystem forward. As such, you can be sure that if you commit to baking our server into your workflow, it will self-improve over time to take advantage of the latest and greatest MCP features.

Servers Available

Productionized Servers

These are PulseMCP-branded servers that we intend to maintain indefinitely as our own offerings.

The MCP Registry column controls whether the server is published to the official MCP Registry (com.pulsemcp/<server-name>) by the publish-mcp-registry.yml workflow.

Name	Description	Local Status	Remote Status	MCP Registry	Target Audience	Notes
pulse-fetch	Pull internet resources into context	0.3.3	Not Started	Yes	Agent-building frameworks (e.g. fast-agent, Mastra, PydanticAI) and MCP clients without built-in fetch	Supports Firecrawl and BrightData integrations; HTML noise stripping; Resource caching; LLM extraction
pulse-subregistry	Browse the PulseMCP Sub-Registry	0.0.8	Not Started	Yes	Developers discovering MCP servers from the PulseMCP Sub-Registry	Search and pagination; Version selection; Integrates with PulseMCP Sub-Registry API
image-diff	Programmatic image comparison	0.1.3	Not Started	Yes	Developers comparing design mocks against UI implementations	Pixel-level diff with clustering; Heatmap visualization; Anti-aliasing detection; Auto-alignment for different-sized images
svg-tracer	Bitmap-to-SVG vector tracing	0.1.3	Not Started	Yes	Developers converting bitmap images to SVG vector graphics	Supports PNG, JPG, WebP, BMP, GIF, TIFF; Alpha channel preprocessing; Target size scaling; Customizable tracing parameters

Experimental Servers

These are high-quality servers that we may discontinue if the official provider creates and maintains a better MCP server.

Name	Description	Local Status	Remote Status	MCP Registry	Target Audience	Notes
agent-orchestrator	Agent parallelization system for agentic coding and ops	0.8.11	Not Started	No	PulseMCP team for agent orchestration	Requires AGENT_ORCHESTRATOR_BASE_URL and API_KEY; Internal use only
appsignal	AppSignal application performance monitoring and error tracking	0.5.4	Not Started	Yes	Developers using AppSignal for application monitoring	Requires AppSignal API key; NOT officially affiliated with AppSignal
claude-code-agent	Claude Code Agent MCP Server for managing Claude Code CLI sessions	0.0.8	Not Started	No	Developers building AI-powered automation workflows	Requires Claude Code CLI installed locally
dynamodb	AWS DynamoDB table and item operations with fine-grained access	0.2.7	Not Started	Yes	Developers using AWS DynamoDB	Requires AWS credentials; Fine-grained tool access control
remote-filesystem	Remote filesystem operations on cloud storage (GCS)	0.1.5	Not Started	Yes	Developers needing cloud storage integration	Requires GCS credentials; Full CRUD operations; Published as `remote-filesystem-mcp-server`
s3	AWS S3 bucket and object management	0.0.5	Not Started	Yes	Developers needing S3 storage integration	Requires AWS credentials; Fine-grained tool access control; Published as `s3-aws-mcp-server`
fetchpet	Fetch Pet insurance claims management	0.1.8	Not Started	Yes	Pet owners with Fetch Pet insurance	Requires Fetch Pet username and password; NOT officially affiliated with Fetch Pet
fly-io	Fly.io cloud platform app and machine management	0.1.7	Not Started	Yes	Developers deploying applications to Fly.io	Requires FLY_IO_API_TOKEN; NOT officially affiliated with Fly.io
gcs	Google Cloud Storage bucket and object management	0.1.14	Not Started	Yes	Developers needing GCS storage integration	Requires GCS credentials; Fine-grained tool access control; Published as `gcs-google-mcp-server`
google-flights	Google Flights search, date grids, and airport lookup	0.2.6	Not Started	Yes	Users searching for flights via Google Flights	No API key required; Uses protobuf-encoded HTTP requests; Published as `google-flights-mcp-server`; NOT officially affiliated with Google
gmail	Gmail integration for email access	0.4.12	Not Started	Yes	Gmail users (personal or Google Workspace)	Supports OAuth2 (personal) and service account (Workspace); NOT officially affiliated with Google
google-calendar	Google Calendar Workspace integration for calendar management	0.0.13	Not Started	Yes	Google Workspace organizations needing Calendar integration	Requires service account with domain-wide delegation; NOT officially affiliated with Google
good-eggs	Good Eggs grocery shopping automation	0.1.11	Not Started	Yes	Users of Good Eggs grocery delivery service	Requires Good Eggs username and password; NOT officially affiliated with Good Eggs
onepassword	1Password credential and secrets management via CLI	0.5.4	Not Started	Yes	Developers using 1Password for secrets management	Requires 1Password CLI and service account token; NOT officially affiliated with 1Password
hatchbox	Hatchbox Rails hosting platform management	0.1.3	Not Started	Yes	Rails developers using Hatchbox for hosting	Requires Hatchbox API key and deploy key
langfuse	Readonly Langfuse LLM trace and observation analysis	0.1.3	Not Started	Yes	Developers using Langfuse for LLM observability	Requires Langfuse API keys; Published as `langfuse-observability-mcp-server`; NOT officially affiliated with Langfuse
monarch-money	Monarch Money personal finance management (read + mutate)	0.0.13	Not Started	Yes	Monarch Money users tracking accounts, transactions, net worth, and budgets	Requires Monarch credentials; tool-group filtering for write protection; NOT officially affiliated with Monarch Money
playwright-stealth	Browser automation with Playwright and optional stealth mode	0.2.3	Not Started	Yes	Developers needing browser automation with anti-bot bypass	Optional stealth mode via STEALTH_MODE env var
pointsyeah	Award flight search across 20+ airline loyalty programs	0.2.9	Not Started	Yes	Travelers optimizing credit card points for flights	Optional PointsYeah refresh token (can be set at runtime); NOT officially affiliated with PointsYeah
proctor	Proctor exam runner for testing MCP servers	0.1.9	Not Started	Yes	PulseMCP team for MCP server testing	Requires PROCTOR_API_KEY; Internal use only
pulsemcp-cms-admin	Internal API for managing PulseMCP newsletter content	0.10.6	Not Started	No	PulseMCP team for content management	Requires PULSEMCP_ADMIN_API_KEY; Internal use only
serpapi-hotels	Google Hotels search, details, and reviews via SerpAPI	0.0.4	Not Started	Yes	Users searching for hotels via Google Hotels	Requires SerpAPI key; NOT officially affiliated with SerpAPI or Google
slack	Slack workspace messaging and collaboration integration	0.0.7	Not Started	Yes	Teams using Slack for team communication	Requires Slack Bot Token; NOT officially affiliated with Slack
ssh	SSH remote server management with agent authentication	0.1.5	Not Started	Yes	Developers needing SSH access to remote servers	Supports SSH agent for passphrase-protected keys
twist	Twist team messaging and collaboration platform integration	0.2.3	Not Started	Yes	Teams using Twist for asynchronous communication	Requires Twist API bearer token and workspace ID
vercel	Vercel deployment management and runtime log retrieval	0.1.3	Not Started	Yes	Developers using Vercel for deployment and hosting	Requires Vercel API token; Published as `vercel-platform-mcp-server`; NOT officially affiliated with Vercel
google-docs	MCP server for Google Docs integration with OAuth2 and service account support	0.1.4	Not Started	Yes	TBD	TBD
tailscale	Tailscale policy (ACL), device, and auth-key management via the REST API	0.0.3	Not Started	Yes	Developers and admins managing Tailscale tailnets	Requires TAILSCALE_API_KEY or OAuth client credentials; policy/ACL, device, and auth-key tools; NOT officially affiliated with Tailscale

Contributing

See CONTRIBUTING.md.

Related MCP servers

com.pulsemcp/good-eggs

Active

Automate Good Eggs grocery shopping with browser automation.

TypeScript

MIT

View repository →

com.pulsemcp/google-calendar

Active

Google Calendar Workspace integration with service account support and domain-wide delegation.

TypeScript

MIT

View repository →

com.pulsemcp/google-docs

Active

Access and manage Google Docs with OAuth2 and service account authentication.

TypeScript

MIT

View repository →

com.pulsemcp/google-flights

Active

Search Google Flights, check date grid pricing, and look up airports—no API key required.

TypeScript

MIT

View repository →

com.pulsemcp/hatchbox

Active

Manage Hatchbox Rails hosting with env inspection, deploys, and process monitoring.

TypeScript

MIT

View repository →

com.pulsemcp/image-diff

Active

Programmatic image comparison and visual diff generation for design validation.

TypeScript

MIT

View repository →