mcpField
G
gmail

gmail

Local
github.com/markswendsen-codeCommunication0Updated 28w ago
Repository

About gmail

gmail is an MCP server that lets AI agents read, search, and send email through Gmail. It supports inbox listing and contextual replies based on message history.

Key features

  1. 01Search with Gmail query syntax
  2. 02Read full email messages
  3. 03List recent inbox messages
  4. 04Send email with CC and BCC

Use cases

  1. 01Triage new messages and identify urgent email
  2. 02Search past conversations for context before replying
  3. 03Draft and send routine communications on a user's behalf

MCP support

Exposes Gmail search, reading, inbox listing, and sending tools to MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "markswendsen-code-gmail": {
      "command": "npx",
      "args": [
        "-y",
        "@striderlabs/mcp-gmail"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
        "GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
        "GOOGLE_REFRESH_TOKEN": "<GOOGLE_REFRESH_TOKEN>"
      }
    }
  }
}
Run commandnpx -y @striderlabs/mcp-gmail
Environment variables to set
GOOGLE_CLIENT_IDGoogle OAuth 2.0 Client ID from Google Cloud Console
GOOGLE_CLIENT_SECRETSecretGoogle OAuth 2.0 Client Secret
GOOGLE_REFRESH_TOKENSecretGoogle OAuth 2.0 Refresh Token for the user's Gmail account

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@striderlabs/mcp-gmail0.1.0

Tools

4

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
ccstringNoCC recipients (comma-separated, optional)
tostringYesRecipient email address
bccstringNoBCC recipients (comma-separated, optional)
bodystringYesEmail body content (plain text)
subjectstringYesEmail subject line

Details

From the project README

@striderlabs/mcp-gmail

MCP server that gives AI agents the ability to send, read, and search email via Gmail.

For Agents

Agents use this connector to handle email autonomously on behalf of their human — reading important messages, searching for information, composing thoughtful replies, and sending communications.

Example agent workflows:

  1. Triage emails: Agent reads new messages, summarizes important ones, and flags urgent items for user attention
  2. Answer routine questions: Agent searches email history to find information, composes replies with context from past conversations
  3. Send on behalf: Agent drafts and sends professional emails based on user intent ("Let the team know I'll be late"), then logs a copy to the conversation

Usage example:

User: "Has anyone replied to my email about the Q2 budget proposal?"

Agent:

  1. gmail_search → "to:me subject:budget"
  2. gmail_read → Read each message
  3. Return summary: "Sarah replied yes on Monday. Mark asked for revisions. No word from Finance yet."

Then agent might automatically draft a follow-up to Finance and ask for approval before sending.

Installation

npx @striderlabs/mcp-gmail

Configuration

Add to your MCP client configuration (e.g., Claude Desktop):

{
  "mcpServers": {
    "strider-gmail": {
      "command": "npx",
      "args": ["-y", "@striderlabs/mcp-gmail"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id",
        "GOOGLE_CLIENT_SECRET": "your-client-secret",
        "GOOGLE_REFRESH_TOKEN": "your-refresh-token"
      }
    }
  }
}

Available Tools

gmail_send

Send an email from the user's Gmail account.

Parameters:

  • to (required): Recipient email address
  • subject (required): Email subject line
  • body (required): Email body content
  • cc (optional): CC recipients
  • bcc (optional): BCC recipients
gmail_search

Search emails using Gmail search syntax.

Parameters:

  • query (required): Gmail search query (e.g., "from:[email protected]")
  • maxResults (optional): Maximum results (default: 10)
gmail_read

Read the full content of a specific email.

Parameters:

  • messageId (required): The Gmail message ID
gmail_list

List recent emails from the inbox.

Parameters:

  • maxResults (optional): Maximum emails to list (default: 10)
  • label (optional): Filter by label (e.g., "INBOX", "UNREAD")

Getting Google OAuth Credentials

  1. Go to Google Cloud Console
  2. Create a new project or select existing
  3. Enable the Gmail API
  4. Create OAuth 2.0 credentials
  5. Use the OAuth playground or your app to get a refresh token

Response Format

All tools return structured JSON:

{
  "success": true,
  "messageId": "...",
  "message": "Email sent successfully"
}

Part of Strider Labs

Strider Labs builds action execution infrastructure for AI agents.

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.