MCP.so
Sign In

Google Workspace MCP Server

@Yulikepython

Repository

About Google Workspace MCP Server

No overview available yet

Config

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

{
  "mcpServers": {
    "google-workspace-mcp-server-by-itc": {
      "command": "node",
      "args": [
        "get-refresh-token.js"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Google Workspace MCP Server?

Google Workspace MCP Server provides Gmail and Google Calendar functionality through the Model Context Protocol (MCP). It is for developers and users who want to control email and calendar operations programmatically via MCP-compatible clients like Claude.

How to use Google Workspace MCP Server?

Clone the repository, run npm install, configure OAuth credentials in credentials.json, and obtain a refresh token by executing node get-refresh-token.js. Then add a server entry to your MCP settings file with the environment variables GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, and GOOGLE_REFRESH_TOKEN. Finally, run npm run build and npm run start.

Key features of Google Workspace MCP Server

  • List recent emails with filtering support
  • Search emails using Gmail query syntax
  • Send emails with CC and BCC support
  • Modify email labels (archive, trash, read/unread)
  • List calendar events with date range
  • Create, update, and delete calendar events

Use cases of Google Workspace MCP Server

  • Automate email triage by searching and labeling messages
  • Schedule meetings with attendees directly from an MCP client
  • Send emails programmatically with CC and BCC
  • Review and manage calendar events within a specified date range

FAQ from Google Workspace MCP Server

What OAuth scopes does the server require?

The server requests https://www.googleapis.com/auth/gmail.modify, https://www.googleapis.com/auth/gmail.send, and https://www.googleapis.com/auth/calendar.

What runtime is required?

Node.js 20 or higher.

How do I get the required credentials?

Enable the Gmail API and Google Calendar API in Google Cloud Console, create an OAuth 2.0 client ID for a desktop application, and set http://localhost:4100/code as an authorized redirect URI.

Where do I configure the MCP server settings?

For Claude Desktop, edit ~/Library/Application Support/Claude/claude_desktop_config.json. For VS Code Claude extension, edit ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json.

How can I troubleshoot authentication issues?

Verify that the required OAuth scopes were granted, check that the Client ID and Client Secret are correct, and ensure the refresh token is still valid.

Frequently asked questions

What OAuth scopes does the server require?

The server requests `https://www.googleapis.com/auth/gmail.modify`, `https://www.googleapis.com/auth/gmail.send`, and `https://www.googleapis.com/auth/calendar`.

What runtime is required?

Node.js 20 or higher.

How do I get the required credentials?

Enable the Gmail API and Google Calendar API in Google Cloud Console, create an OAuth 2.0 client ID for a desktop application, and set `http://localhost:4100/code` as an authorized redirect URI.

Where do I configure the MCP server settings?

For Claude Desktop, edit `~/Library/Application Support/Claude/claude_desktop_config.json`. For VS Code Claude extension, edit `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`.

How can I troubleshoot authentication issues?

Verify that the required OAuth scopes were granted, check that the Client ID and Client Secret are correct, and ensure the refresh token is still valid.

Comments

Basic information

Category

Other

License

MIT

Transports

stdio

Author

Yulikepython

More Other MCP servers

AutoBrowser MCP

autobrowser-ai

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

MCP Go 🚀

mark3labs

A Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.

8.9K

XcodeBuildMCP

cameroncooke

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

6.0K

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov