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

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K
Advertise