Сервер MCP для Google Tasks

Этот сервер протокола Model Context Protocol (MCP) обеспечивает связь между клиентами MCP и Google Tasks, позволяя вам управлять своими списками задач и задачами напрямую из таких клиентов, как Claude Desktop, Cursor и Codex.

Функции

Этот сервер MCP предоставляет следующие возможности:

Управление списками задач

• list-tasklists — список всех ваших списков задач

• get-tasklist — получение подробной информации о конкретном списке задач

• create-tasklist — создание нового списка задач

• update-tasklist — обновление существующего списка задач

• delete-tasklist — удаление списка задач

Управление задачами

• list-tasks — список всех задач в списке задач, включая постраничные результаты

• get-task — получение подробной информации о конкретной задаче

• create-task — создание новой задачи

• update-task — обновление существующей задачи

• delete-task — удаление задачи

• complete-task — отметить задачу как выполненную

• move-task — перемещение задачи (изменение порядка, родительского элемента или перемещение между списками задач)

• clear-completed-tasks — удаление всех выполненных задач из списка

Related MCP server: Google Search MCP Server

Инструкции по настройке

1. Создание проекта в Google Cloud и включение API

1. Перейдите в Google Cloud Console

2. Создайте новый проект

3. Перейдите в "APIs & Services" > "Library"

4. Найдите "Google Tasks API" и включите его

5. Перейдите в "APIs & Services" > "Credentials"

6. Нажмите "Create Credentials" > "OAuth Client ID"

7. Настройте экран согласия OAuth (для личного использования подойдет "External")

8. В качестве типа приложения выберите "Web application"

9. Добавьте "http://localhost:3000/oauth2callback" в качестве разрешенного URI перенаправления

10. Создайте идентификатор клиента и секретный ключ

2. Настройка переменных окружения

Создайте файл .env в директории проекта:

GOOGLE_CLIENT_ID=your_client_id_here
GOOGLE_CLIENT_SECRET=your_client_secret_here
GOOGLE_REDIRECT_URI=http://localhost:3000/oauth2callback

Переменные окружения:

• GOOGLE_CLIENT_ID (обязательно) — ваш идентификатор клиента Google OAuth

• GOOGLE_CLIENT_SECRET (обязательно) — ваш секретный ключ клиента Google OAuth

• GOOGLE_REDIRECT_URI (опционально) — URI перенаправления OAuth (по умолчанию http://localhost:3000/oauth2callback)

Примечание: Сервер проверяет наличие GOOGLE_CLIENT_ID и GOOGLE_CLIENT_SECRET при запуске и выдает понятные сообщения об ошибках, если они отсутствуют или неверны.

3. Сборка сервера

1. Установите зависимости:

npm install

2. Соберите сервер:

npm run build

4. Настройка клиента MCP

Codex

Добавьте сервер в ~/.codex/config.toml:

[mcp_servers.google-tasks]
command = "zsh"
args = ["-lc", "cd /path/to/google-tasks-mcp && exec node build/index.js"]

Замените /path/to/google-tasks-mcp на путь к этому проекту, затем перезапустите Codex.

Чтобы проверить, зарегистрирован ли сервер:

codex mcp list
codex mcp get google-tasks

Claude for Desktop

1. Установите Claude for Desktop

2. Откройте файл конфигурации Claude:

   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

3. Добавьте конфигурацию сервера Google Tasks MCP:

{
  "mcpServers": {
    "google-tasks": {
      "command": "node",
      "args": ["/path/to/google-tasks-mcp/build/index.js"]
    }
  }
}

Замените путь на свой, затем перезапустите Claude for Desktop.

Процесс аутентификации

При первом использовании сервера Google Tasks MCP:

1. Используйте инструмент authenticate, чтобы получить URL авторизации

2. Перейдите по этому URL в браузере и войдите в свою учетную запись Google

3. После авторизации вы получите код на странице браузера

4. Используйте инструмент set-auth-code с этим кодом, чтобы завершить аутентификацию

5. Теперь вы можете использовать все остальные инструменты для взаимодействия с Google Tasks

Примечание: Ваши токены аутентификации (включая токены обновления) автоматически сохраняются на диске по адресу ~/.config/google-tasks-mcp/credentials.json с ограниченными правами доступа (600). Это означает:

• Вам нужно аутентифицироваться только один раз — учетные данные сохраняются после перезапуска сервера

• Автоматическое обновление токенов — токены доступа автоматически обновляются по истечении срока действия (обычно через 1 час) с использованием сохраненного токена обновления

• Повторная аутентификация не требуется — после первоначальной настройки вам не нужно будет проходить аутентификацию снова, если вы не отзовете доступ или не удалите файл учетных данных

Требования

• Node.js 20+ (см. engines в package.json)

• Клиент, совместимый с MCP

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

Особенности реализации

Этот сервер MCP включает следующие улучшения:

• Постоянное хранилище токенов — учетные данные аутентификации сохраняются на диске (~/.config/google-tasks-mcp/credentials.json) с ограниченными правами доступа, поэтому вам нужно аутентифицироваться только один раз

• Проверка переменных окружения — проверка при запуске гарантирует, что необходимые учетные данные настроены, с выводом понятных сообщений об ошибках

• Автоматическое обновление токенов — токены OAuth автоматически обновляются при истечении срока действия, что устраняет необходимость повторной аутентификации во время активных сессий или после перезапуска

• Улучшенная проверка входных данных — комплексная проверка всех входных данных, включая форматы ID, длину строк и форматы даты RFC 3339

• Санитизация HTML — ответы обратного вызова OAuth очищаются для предотвращения уязвимостей XSS

• Корректное завершение работы — надлежащая очистка ресурсов при сигналах SIGINT/SIGTERM

• Безопасность типов — полная безопасность типов TypeScript во всей кодовой базе с использованием соответствующих интерфейсов

• Настраиваемый URI перенаправления — URI перенаправления OAuth можно настроить с помощью переменной окружения GOOGLE_REDIRECT_URI

Скриншоты

Claude Desktop

Cursor

Лицензия

Этот проект предназначен только для демонстрационных целей. Используйте на свой страх и риск.