aaronsb/google-workspace-mcp
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
aaronsb/google-workspace-mcp — это кандидат для MCP-сервера, импортированный из https://github.com/aaronsb/google-workspace-mcp.
Обзор
aaronsb/google-workspace-mcp — это кандидат для MCP-сервера, импортированный из https://github.com/aaronsb/google-workspace-mcp.
Обзор (машинный перевод)
Дайте своему агенту ИИ реальный доступ к Google Workspace — Gmail, Календарь, Диск, Документы, Таблицы, Задачи, Встреча и Контакты — с одного MCP-сервера, на столько аккаунтов, сколько у вас есть.
Ищите в почте, проверяйте календарь, пишите документ, задавайте задание — в разговоре, за самого себя.
Установка
Во-первых, вам нужны Google OAuth credentials — единственное требование, общую для каждого пути:
- Перейти к console.cloud.google.com/apis/credentials
- Создать OAuth 2.0 Client ID, тип приложения Десктопное приложение
- Включите нужные API (Gmail, Календарь, Диск, Таблицы, Документы, Задачи, Meet — и People API для контактов, так Google называет это в консоли)
- Держите под рукой Client ID и Client Secret — вы вставите их ниже
Затем выберите путь, который соответствует вашему стилю работы. Все три работают на одном сервере.
Узел 22.12 или новее. (Узлы 18 и 20 оба находятся в конце срока службы.)
📦 → 🤖 Claude Desktop — установка одним кликом .mcpb (рекомендовано)
Скачайте google-workspace-mcp.mcpb из последней версии, затем перетащите его в окно рабочего стола Claude или дважды кликните.
Claude Desktop открывает диалог установки с тремя полями:
| Поле | |—|—|
Эта страница переведена автоматически. Технические детали смотрите в оригинале.
README
Показан фрагмент оригинального README. Открыть оригинал.
Google Workspace MCP Server
Give your AI agent real access to Google Workspace — Gmail, Calendar, Drive, Docs, Sheets, Tasks, Meet and Contacts — from one MCP server, across as many accounts as you have.
Search your mail, check your calendar, write a doc, file a task — in conversation, as yourself.
Install
First, you need Google OAuth credentials — the one prerequisite common to every path:
- Go to console.cloud.google.com/apis/credentials
- Create an OAuth 2.0 Client ID, application type Desktop app
- Enable the APIs you want (Gmail, Calendar, Drive, Sheets, Docs, Tasks, Meet — and People API for contacts, which is what Google calls it in the console)
- Keep the Client ID and Client Secret handy — you’ll paste them in below
Then pick the path that matches how you work. All three run the same server.
Node 22.12 or newer. (Node 18 and 20 are both end-of-life.)
📦 → 🤖 Claude Desktop — one-click .mcpb install (recommended)
Download google-workspace-mcp.mcpb from the latest release, then drag it onto the Claude Desktop window, or double-click it.
Claude Desktop opens an install dialog with three fields:
| Field | |
|---|---|
| Google OAuth Client ID | required — from the step above |
| Google OAuth Client Secret | required — from the step above |
| Workspace Directory | optional — where attachments, downloads and exports land. Defaults to ~/.local/share/google-workspace-mcp/workspace/. Give it a dedicated folder — not your home, Documents, Desktop, or a Google Drive folder. |
Paste, hit Save, done. No JSON to edit, no Node to install, no paths to get right — the bundle carries the server and every dependency.
One bundle covers every platform — macOS (Intel and Apple Silicon), Linux (x64 and ARM64), and Windows. There is nothing to choose: the server is pure JavaScript, so there is no platform-specific payload to pick between.
Установка
npx -y @aaronsb/google-workspace-mcpКонфигурация
{
"mcpServers": {
"google-workspace": {
"command": "npx",
"args": ["-y", "@aaronsb/google-workspace-mcp"],
"env": {
"GOOGLE_CLIENT_ID": "your-client-id",
"GOOGLE_CLIENT_SECRET": "your-client-secret"
}
}
}
}