Google Tasks MCP

MCP-сервер, который позволяет ИИ-агентам читать задачи Google Tasks пользователя и управлять ими. Он использует официальный API Google Tasks, учетные данные OAuth 2.0 Desktop App и MCP TypeScript SDK через stdio.

Возможности

• Просматривать, инспектировать, создавать, переименовывать и удалять списки задач

• Просматривать и фильтровать задачи с пагинацией через API

• Создавать, редактировать, завершать, переоткрывать, перемещать, изменять порядок и удалять задачи

• Создавать и перемещать подзадачи с помощью parent и previous

• Очищать завершенные задачи

• Аннотации безопасности MCP и явное подтверждение для разрушительных операций

• OAuth refresh-токен хранится вне репозитория с правами только для владельца

Требования

• Node.js 20 или новее

• Учетная запись Google

• Проект Google Cloud с включенным Google Tasks API

1. Настройка Google Cloud

1. Откройте Google Cloud Console.

2. Создайте или выберите проект.

3. Включите Google Tasks API в разделе APIs & Services → Library.

4. Настройте экран согласия OAuth.

5. В разделе APIs & Services → Credentials создайте OAuth client ID с типом приложения Desktop app.

6. Скачайте JSON-файл OAuth Desktop client как client_secret.json и храните его защищенным вне этого репозитория.

2. Установка, сборка и авторизация

npm install
npm run build
npm run auth -- --client-secret /secure/google/client_secret.json

Команда авторизации принимает только JSON-файл Google OAuth Desktop client, содержащий объект installed верхнего уровня. Она открывает браузерный поток согласия и сохраняет refresh-токен Tasks в:

~/.config/google-tasks-mcp/token.json

При необходимости переопределите расположение сгенерированного токена:

GOOGLE_TOKEN_FILE=/secure/google/tasks-token.json \
npm run auth -- --client-secret /secure/google/client_secret.json

Для установленного пакета выполните:

google-tasks-mcp-auth --client-secret /secure/google/client_secret.json

Сервер запрашивает полную область https://www.googleapis.com/auth/tasks, поскольку он предоставляет как операции чтения, так и записи. Последующие запуски MCP-сервера используют сохраненный токен и автоматически обновляют доступ; предоставляйте client_secret.json снова только при авторизации или повторной авторизации проекта. Никогда не коммитьте ни один из JSON-файлов.

3. Подключение MCP-хоста

Используйте собранный сервер непосредственно из этого репозитория. Замените пути на абсолютные пути на вашей машине.

Codex (~/.codex/config.toml)

[mcp_servers.google_tasks]
command = "node"
args = ["/absolute/path/google-task-mcp/dist/index.js"]

[mcp_servers.google_tasks.env]
GOOGLE_TOKEN_FILE = "/Users/you/.config/google-tasks-mcp/token.json"

Хосты, использующие JSON-конфигурацию

{
  "mcpServers": {
    "google_tasks": {
      "command": "node",
      "args": ["/absolute/path/google-task-mcp/dist/index.js"],
      "env": {
        "GOOGLE_TOKEN_FILE": "/Users/you/.config/google-tasks-mcp/token.json"
      }
    }
  }
}

Перезапустите MCP-хост после изменения его конфигурации.

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

Google Tasks хранит только дату из временной метки срока. Время суток, отправленное через API, отбрасывается. Заголовки задач ограничены 1 024 символами, а заметки — 8 192 символами.

Тестирование с MCP Inspector

npm run build
npm run inspect

Протокол stdio использует только stdout. Поэтому диагностика времени выполнения записывается в stderr.

Упаковка для распространения

Создайте устанавливаемый npm-тарбол:

npm pack

После публикации пакета хост может запустить его с помощью:

{
  "command": "npx",
  "args": ["-y", "google-tasks-mcp@0.1.0"],
  "env": {
    "GOOGLE_TOKEN_FILE": "/secure/google/tasks-token.json"
  }
}

Для одного пользователя на одной рабочей станции stdio с локальным токеном — самое простое и безопасное развертывание. Для нескольких пользователей или размещенного сервиса используйте MCP Streamable HTTP и реализуйте OAuth-сеансы для каждого пользователя и зашифрованное хранение токенов на стороне сервера; не используйте один refresh-токен для нескольких пользователей.

Ссылки

• Справочник REST Google Tasks API

• Поля ресурсов Google Tasks

• Порядок Google Tasks

• Google OAuth 2.0

• MCP TypeScript SDK