Google Task MCP

Локальный MCP-сервер и плагин Codex для просмотра, создания, обновления, завершения, отмены завершения и удаления задач Google. Он использует OAuth 2.0 и запрашивает только область Google Tasks:

https://www.googleapis.com/auth/tasks

Требования

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

• Проект Google Cloud

• Codex или другой MCP-клиент, поддерживающий локальные STDIO-серверы

Related MCP server: Google Tasks MCP Server

Настройка Google Cloud

1. В Google Cloud Console создайте или выберите проект.

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

3. Настройте экран согласия OAuth. Добавьте себя в качестве тестового пользователя, пока приложение находится в режиме тестирования.

4. Создайте идентификатор клиента OAuth типа Desktop app. Добавьте http://127.0.0.1:53682/oauth2callback в качестве авторизованного URI перенаправления, если конфигурация клиента позволяет управлять URI перенаправления.

Установка зависимостей

npm install
npm run check

Настройка учетных данных

Установите следующие переменные в окружении, которое запускает Codex. Файл .env.example описывает требуемые значения; сервер намеренно не загружает .env автоматически.

GOOGLE_TASKS_CLIENT_ID
GOOGLE_TASKS_CLIENT_SECRET
GOOGLE_TASKS_REDIRECT_URI=http://127.0.0.1:53682/oauth2callback

При желании установите GOOGLE_TASKS_TOKEN_PATH, чтобы указать, где хранится локальный токен OAuth.

Использование в качестве плагина Codex

Репозиторий уже включает .codex-plugin/plugin.json и .mcp.json. Установите его через локальный маркетплейс плагинов Codex, затем перезапустите Codex, чтобы загрузились встроенный STDIO-сервер и определения инструментов.

Для разработки без упаковки настройте сервер напрямую в Codex, используя:

command: node
args: <absolute-repository-path>/server/index.js

После подключения Codex вызовите google_tasks_get_authorization_url, откройте полученный URL, подтвердите доступ и вызовите google_tasks_complete_authorization.

Токен обновления по умолчанию хранится локально по пути %APPDATA%\\google-task-mcp\\token.json. Установите GOOGLE_TASKS_TOKEN_PATH, чтобы выбрать другой локальный путь. Удалите этот файл, чтобы отключить учетную запись.

Инструменты и безопасность

Сервер предоставляет инструменты для просмотра списков задач и задач, создания и обновления задач, завершения или отмены завершения задачи, а также удаления задачи. Удаление отклоняется, если confirm не установлен в true; вызывающие стороны должны сначала показать точную задачу, которая будет удалена. Другие изменения немедленно применяются к Google Tasks.

Авторизация OAuth требует, чтобы слушатель обратного вызова loopback оставался запущенным. Обратный вызов браузера отображает простую страницу успеха или ошибки и никогда не раскрывает токены в URL или выводе инструмента.

Локальное тестирование

Запустите npm run check для проверки синтаксиса. Вызовы OAuth/API требуют настроенных учетных данных и интерактивной авторизации в браузере.

Конфиденциальность

Учетные данные OAuth и данные задач остаются на локальной машине, за исключением запросов, отправляемых напрямую к API Google. Никогда не фиксируйте в репозитории файл .env или сгенерированный файл токена. Оба исключены с помощью .gitignore.

Лицензия

Выпущено под лицензией MIT.