gMCP (Johnie)

🔗 gmcp

MCP server for Gmail and Google Calendar integration.

by @johnie

概述

GMCP是一个 模型上下文协议 使LLM能够与Gmail和谷歌日历交互的服务器。它提供了搜索电子邮件、管理标签、发送消息和处理日历事件的工具，所有这些都是通过安全的OAuth2身份验证完成的。

安装

NPM（推荐）

# Install globally
npm install -g gmcp

# Or run directly
npx gmcp
bunx gmcp

码头工人

docker pull johnie/gmcp:latest

来源

git clone https://github.com/johnie/gmcp.git
cd gmcp
bun install

快速开始

1.谷歌云设置

1. 在中创建项目 谷歌云控制台
2. 启用 Gmail API 和 日历API
3. 创建 OAuth 2.0客户端ID （桌面应用程序类型）
4. 下载凭据JSON文件

2.身份验证

# If installed globally
gmcp auth

# Or with npx
npx gmcp auth

# Or from source
bun run auth

您的浏览器将自动打开。授权后，身份验证代码将通过本地回调服务器自动捕获，无需手动复制。

手动模式： 如果本地服务器不工作（例如，端口冲突、远程环境），请使用 --manual 自己从URL复制代码：

gmcp auth --manual

3.跑步

# Globally installed
gmcp start
# or just: gmcp

# With npx
npx gmcp start

# From source
bun run start

Claude桌面集成

使用npx（推荐）

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "gmcp": {
      "command": "npx",
      "args": ["-y", "gmcp"],
      "env": {
        "GOOGLE_CREDENTIALS_PATH": "/path/to/credentials.json",
        "GOOGLE_TOKEN_PATH": "/path/to/token.json",
        "GOOGLE_SCOPES": "gmail.readonly,gmail.send,calendar.events"
      }
    }
  }
}

使用Docker

{
  "mcpServers": {
    "gmcp": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "/path/to/credentials.json:/app/data/credentials.json:ro",
        "-v", "/path/to/token.json:/app/data/token.json",
        "-e", "GOOGLE_CREDENTIALS_PATH=/app/data/credentials.json",
        "-e", "GOOGLE_TOKEN_PATH=/app/data/token.json",
        "-e", "GOOGLE_SCOPES=gmail.readonly,gmail.send,calendar.events",
        "johnie/gmcp:latest"
      ]
    }
  }
}

使用Bun（来源）

{
  "mcpServers": {
    "gmcp": {
      "command": "bun",
      "args": ["run", "/path/to/gmcp/src/cli.ts"],
      "env": {
        "GOOGLE_CREDENTIALS_PATH": "/path/to/credentials.json",
        "GOOGLE_TOKEN_PATH": "/path/to/token.json",
        "GOOGLE_SCOPES": "gmail.readonly,gmail.send,calendar.events"
      }
    }
  }
}

工具

Gmail（17个工具）

日历（4个工具）

配置

环境变量

范围

示例：

# Read-only
GOOGLE_SCOPES=gmail.readonly,calendar.readonly

# Full access
GOOGLE_SCOPES=gmail.readonly,gmail.modify,gmail.send,calendar.events

CLI参考

gmcp [command]

Commands:
  start    Start MCP server (default)
  auth     Run OAuth2 authentication flow

Options:
  --help, -h       Show usage
  --version, -v    Show version

Auth Options:
  --manual, -m     Skip local callback server; manually paste code from URL

测试

bunx @modelcontextprotocol/inspector bun run start

许可证

麻省理工学院