gtasks-mcp

Сервер Model Context Protocol для Google Tasks — список, поиск, создание, обновление, удаление и очистка задач из Claude (или любого MCP-совместимого клиента).

Адаптировано из zcaceres/gtasks-mcp (MIT), переписано на чистом Node/TypeScript вместо Bun, с вынесением учётных данных полностью за пределы репозитория (см. Безопасность ниже) и полным набором тестов.

Настройка

1. Создайте OAuth-клиент Google Cloud

1. Перейдите в Google Cloud Console, создайте проект (или используйте существующий).

2. Включите Google Tasks API (APIs & Services → Library).

3. Настройте экран согласия OAuth (External подходит для личного использования — вы будете единственным тестовым пользователем).

4. Создайте учётные данные → OAuth client ID → Тип приложения Desktop app.

5. Скачайте JSON-файл.

2. Установите файл OAuth-клиента

mkdir -p ~/.gtasks-mcp
mv ~/Downloads/client_secret_*.json ~/.gtasks-mcp/oauth-keys.json

В Windows: %USERPROFILE%\.gtasks-mcp\oauth-keys.json.

3. Соберите и авторизуйтесь

npm install
npm run build
npm run auth

Это откроет окно браузера для процесса согласия Google. В случае успеха файл credentials.json (ваш токен обновления/доступа) будет записан рядом с oauth-keys.json в ~/.gtasks-mcp/.

4. Зарегистрируйте сервер в Claude Code

claude mcp add gtasks -- node /absolute/path/to/gtasks-mcp/dist/index.js

Related MCP server: mcp-google-tasks

Доступные инструменты

Безопасность

• Учётные данные никогда не хранятся внутри этого репозитория. oauth-keys.json (ваш OAuth-клиент Google Cloud) и credentials.json (ваш личный токен доступа/обновления, созданный командой npm run auth) оба хранятся в ~/.gtasks-mcp/ — в области пользовательских настроек ОС, а не в каталоге проекта. В репозитории нет файла, игнорируемого git, который можно случайно добавить через git add -f; секреты вообще недоступны из рабочего дерева репозитория. Точные пути см. в src/config.ts.

• credentials.json эквивалентен паролю к вашим Google Tasks — любой, у кого есть этот файл, может читать/записывать ваши задачи. Относитесь к нему соответственно (не отправляйте по электронной почте, не вставляйте в чат, не сохраняйте в общем доступе).

• Зависимости: только @google-cloud/local-auth, googleapis и @modelcontextprotocol/sdk — все официальные (Google / Anthropic). Никакой телеметрии, никаких сторонних сетевых вызовов; каждый запрос идёт к собственным API Google.

• Известные, принятые транзитивные уязвимости (npm audit, проверено 2026-08-25): проблемы средней степени серьёзности в esbuild/vite (инструменты только для разработки, не входят в рантайм) и uuid (через gaxios/googleapis, нет пути ввода недоверенных буферов в реальном использовании этого сервера). Обе требуют обновления основной версии с нарушением совместимости на стороне вышестоящих пакетов; вернитесь к этому при следующей периодической проверке зависимостей, а не форсируйте непроверенное обновление.

Разработка

npm test        # vitest
npm run lint     # eslint (narrow scope — see eslint.config.js)
npm run typecheck
npm run build