Google Workspace MCP Server

Name: Google Workspace MCP Server
Author: Yulikepython

@Yulikepython

代码仓库

关于 Google Workspace MCP Server

暂无概览

基本信息

分类

其他

许可证

MIT

运行时

node

传输方式

stdio

发布者

Yulikepython

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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.