Advertise
MCP.so
Sign In

MCP Google Workspace Server

@j3k0

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

j3k0

About MCP Google Workspace Server

MCP Server for Gmail and Calendar

MCP Google Workspace Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-google-workspace": {
      "command": "npx",
      "args": [
        "mcp-gmail-authenticate"
      ]
    }
  }
}

MCP Google Workspace Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is MCP Google Workspace Server?

MCP Google Workspace Server is a Model Context Protocol server that provides tools for interacting with Gmail and Google Calendar services. It is designed for developers and AI assistants needing programmatic access to Google Workspace data through the MCP protocol.

How to use MCP Google Workspace Server?

Install dependencies with npm install, build TypeScript with npm run build, configure OAuth 2.0 credentials in .gauth.json and accounts in .accounts.json, then authenticate with npm run authenticate. Start the server with npm start. Use optional arguments like --gauth-file, --accounts-file, or --credentials-dir to customize paths. Configure Claude Desktop by editing its claude_desktop_config.json with an MCP server entry pointing to the launch script or the published npm package via npx.

Key features of MCP Google Workspace Server

  • Query emails with advanced Gmail search syntax
  • Read full email content, attachments, and metadata
  • Create, manage, and delete email drafts
  • Reply to emails with send or draft options
  • Archive emails individually or in bulk
  • List, view, create, and delete calendar events

Use cases of MCP Google Workspace Server

  • Automating email organization and response workflows
  • Drafting replies based on email content analysis
  • Searching and summarizing unread or filtered emails
  • Scheduling and managing calendar events programmatically
  • Archiving or saving attachments across multiple emails

Frequently asked questions

1

What Google services does MCP Google Workspace Server integrate with?

It integrates with Gmail and Google Calendar, providing tools to query, read, draft, reply to, and archive emails, as well as manage calendar events across multiple accounts.

2

What are the runtime requirements?

Node.js version 20 or higher is required, along with a Google Cloud project that has the Gmail API and Google Calendar API enabled, plus OAuth 2.0 credentials.

3

How does authentication work?

OAuth 2.0 is used. You create a `.gauth.json` file with your Google OAuth credentials, list accounts in `.accounts.json`, then run `npm run authenticate` to complete the OAuth consent flow for each account. Tokens are stored locally.

4

Can I use multiple Google accounts?

Yes, MCP Google Workspace Server supports multiple accounts. Each account is configured in `.accounts.json` with optional metadata and descriptions that the AI assistant can use.

5

Can the server send emails or only create drafts?

Sending emails is disabled by default. The `GMAIL_ALLOW_SENDING` environment variable must be set to `true` to allow `gmail_send` to actually send mail. Draft creation is also disabled by default unless `GMAIL_ALLOW_DRAFTS` is set to `true`.

Comments

More Other MCP servers

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

MaxKB

1Panel-dev

πŸ”₯ MaxKB is an open-source platform for building enterprise-grade agents. εΌΊε€§ζ˜“η”¨ηš„εΌ€ζΊδΌδΈšηΊ§ζ™Ίθƒ½δ½“εΉ³ε°γ€‚

22.0K

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

Advertise