Google Tasks MCP Server
Сервер MCP для Google Tasks
Этот сервер протокола Model Context Protocol (MCP) обеспечивает связь между клиентами MCP и Google Tasks, позволяя вам управлять своими списками задач и задачами напрямую из таких клиентов, как Claude Desktop, Cursor и Codex.
[!NOTE] Весь код в этом проекте (за исключением некоторых правок) был "vibe coded" (https://en.wikipedia.org/wiki/Vibe_coding) — сгенерирован с помощью Claude/Copilot по моим инструкциям.
Функции
Этот сервер 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 Tasks MCP Server
Инструкции по настройке
1. Создание проекта в Google Cloud и включение API
Перейдите в Google Cloud Console
Создайте новый проект
Перейдите в "APIs & Services" > "Library"
Найдите "Google Tasks API" и включите его
Перейдите в "APIs & Services" > "Credentials"
Нажмите "Create Credentials" > "OAuth Client ID"
Настройте экран согласия OAuth (для личного использования подойдет "External")
В качестве типа приложения выберите "Web application"
Добавьте "http://localhost:3000/oauth2callback" в качестве разрешенного URI перенаправления
Создайте идентификатор клиента и секретный ключ
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 OAuthGOOGLE_CLIENT_SECRET(обязательно) — ваш секретный ключ клиента Google OAuthGOOGLE_REDIRECT_URI(опционально) — URI перенаправления OAuth (по умолчаниюhttp://localhost:3000/oauth2callback)
Примечание: Сервер проверяет наличие GOOGLE_CLIENT_ID и GOOGLE_CLIENT_SECRET при запуске и выдает понятные сообщения об ошибках, если они отсутствуют или неверны.
3. Сборка сервера
Установите зависимости:
npm installСоберите сервер:
npm run build4. Настройка клиента 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-tasksClaude for Desktop
Установите Claude for Desktop
Откройте файл конфигурации Claude:
MacOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Добавьте конфигурацию сервера Google Tasks MCP:
{
"mcpServers": {
"google-tasks": {
"command": "node",
"args": ["/path/to/google-tasks-mcp/build/index.js"]
}
}
}Замените путь на свой, затем перезапустите Claude for Desktop.
Процесс аутентификации
При первом использовании сервера Google Tasks MCP:
Используйте инструмент
authenticate, чтобы получить URL авторизацииПерейдите по этому URL в браузере и войдите в свою учетную запись Google
После авторизации вы получите код на странице браузера
Используйте инструмент
set-auth-codeс этим кодом, чтобы завершить аутентификациюТеперь вы можете использовать все остальные инструменты для взаимодействия с 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

Лицензия
Этот проект предназначен только для демонстрационных целей. Используйте на свой страх и риск.
Available Tools
15 toolsauthenticateB
Get URL to authenticate with Google Tasks
Inputs: no named parameters.
clear-completed-tasksC
Clear all completed tasks from a task list
Inputs: tasklist (required).
complete-taskC
Mark a task as completed
Inputs: tasklist (required), task (required).
create-taskC
Create a new task in a task list
Inputs: tasklist (required), title (required), notes, due.
create-tasklistC
Create a new task list
Inputs: title (required).
delete-taskC
Delete a task
Inputs: tasklist (required), task (required).
delete-tasklistC
Delete a task list
Inputs: tasklist (required).
get-taskC
Get a specific task by ID
Inputs: tasklist (required), task (required).
get-tasklistC
Get a task list by ID
Inputs: tasklist (required).
list-tasklistsB
List all task lists
Inputs: no named parameters.
list-tasksC
List all tasks in a task list
Inputs: tasklist (required), showCompleted, showHidden, showDeleted.
move-taskC
Move a task to another position
Inputs: tasklist (required), task (required), parent, previous.
set-auth-codeC
Set the authentication code received from Google OAuth flow
Inputs: code (required).
update-taskC
Update an existing task
Inputs: tasklist (required), task (required), title, notes, +2 more.
update-tasklistC
Update an existing task list
Inputs: tasklist (required), title (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 15 tools
Every tool has a clearly distinct purpose with no ambiguity. Each tool targets specific resources (tasks or tasklists) and actions (create, get, list, update, delete, complete, clear, move), making it easy for an agent to select the right tool. The separation between task operations and tasklist operations is particularly clear.
The naming follows a perfectly consistent verb-noun pattern throughout all 15 tools. Every tool uses snake_case with clear action verbs (create, get, list, update, delete, etc.) followed by the resource name (task, tasklist), and multi-word resources use hyphens consistently (e.g., clear-completed-tasks).
With 15 tools, this server is well-scoped for managing Google Tasks. Each tool earns its place by covering essential CRUD operations for both tasks and tasklists, plus additional workflow actions like moving tasks and clearing completed ones. The count is appropriate for the domain without being overwhelming.
The tool surface provides complete coverage for the Google Tasks domain. It includes full CRUD operations for both tasks and tasklists, plus lifecycle actions like completing tasks, moving tasks, and clearing completed tasks. Authentication tools are also included, ensuring no dead ends for agents.
Maintenance
Related MCP Connectors
MCP server for Google Tasks: review, plan and tidy your tasks by asking. Deletes always ask first.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Official Todoist MCP server. Manage tasks and projects. Hosted, no API key needed.
Simple, fast todo app: manage tasks, projects and tags from Claude and other MCP clients.
Related MCP Servers
- AlicenseAqualityBmaintenanceA Model Context Protocol server that connects Claude Desktop to AI Note task management, enabling task creation, updates and management through natural language conversations.5157 npm1MIT
- AlicenseNot gradedqualityBmaintenanceA Model Context Protocol (MCP) server that brings your Google Tasks into Claude and other MCP-compatible clients, enabling task and task list management through natural conversation.49 npm14MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables Claude to fully manage Google Calendar, including events, calendars, sharing, and availability checks through natural language.1MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables AI assistants to manage Google Tasks, including creating, updating, deleting, and searching tasks and task lists via OAuth2 authentication.23 npm1Apache 2.0