Google Workspace MCP Server

Name: Google Workspace MCP Server
Author: epaproditus

@epaproditus

代码仓库

关于 Google Workspace MCP Server

A Model Context Protocol server for Google Workspace integration (Gmail and Calendar)

#google-workspace #mcp #gmail #calendar #integration

基本信息

分类

其他

许可证

MIT

运行时

node

传输方式

stdio

发布者

epaproditus

配置

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

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

工具

未检测到工具

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

概览

What is Google Workspace MCP Server?

A Model Context Protocol (MCP) server that provides tools for interacting with Gmail and Calendar APIs. It enables managing emails and calendar events programmatically through the MCP interface.

How to use Google Workspace MCP Server?

Requires Node.js 14+, a Google Cloud project with Gmail API and Calendar API enabled, and OAuth 2.0 credentials. Clone the repository, install dependencies, create a credentials.json, run node get-refresh-token.js to get a refresh token, configure the MCP settings file with environment variables, then build and run.

Key features of Google Workspace MCP Server

List, search, send, and modify Gmail emails
List, create, update, and delete Calendar events
Gmail email labeling (archive, trash, mark read/unread)
Calendar event support for attendees and date filtering
OAuth 2.0 authentication with refresh token

Use cases of Google Workspace MCP Server

Automate email management: list unread, send, archive
Search emails using Gmail query syntax
Manage calendar events: create meetings with attendees
Update or delete existing calendar events programmatically

FAQ from Google Workspace MCP Server

What prerequisites are required?

Node.js version 14 or higher, a Google Cloud project with the Gmail API and Calendar API enabled, and OAuth 2.0 credentials (Client ID, Client Secret).

How do I authenticate with Google?

You must create a credentials.json file and run node get-refresh-token.js, which opens a browser for OAuth consent. The refresh token is saved to token.json and displayed.

What Google OAuth scopes are requested?

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

How is the server configured in an MCP host?

Add a configuration entry to your MCP settings file with the command node, the path to build/index.js, and environment variables GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, and GOOGLE_REFRESH_TOKEN.

What if I get API errors?

Check Google Cloud Console for API quotas/limits, ensure the Gmail and Calendar APIs are enabled for your project, and verify request parameters match the required format.

其他分类下的更多 MCP 服务器

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K