AI导哈

任务管理MCP服务器

这是一个基于Google Tasks API的MCP服务器，允许AI代理读取、创建、更新和删除任务，并支持任务列表管理、截止日期设置、任务排序等操作。

  • by PavloJedi
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 PavloJedi/google-tasks-mcp

使用说明

google-tasks-mcp

MCP server for the Google Tasks API. It allows any AI agent (Claude, Cursor, and others) to read, create, update, and delete tasks via Google Tasks.

Tools

Tool What it does
list_task_lists Lists all task lists
list_tasks Lists tasks from a list (filters: date, status)
get_task Returns a single task by ID
create_task Creates a task (title, notes, due, parent)
update_task Updates any task field
complete_task Marks a task as completed
delete_task Permanently deletes a task
move_task Moves/reorders a task

Setup (one-time)

1. Google Cloud Console

  1. Go to console.cloud.google.com
  2. Create a project (or select an existing one)
  3. Open APIs & Services -> Library -> find "Tasks API" -> Enable
  4. Open APIs & Services -> Credentials
  5. Create Credentials -> OAuth client ID
    • Application type: Desktop app
    • Name: google-tasks-mcp
  6. Download the JSON file -> rename it to .credentials.json -> place it in the project root

2. Install dependencies

npm install

3. Authorize (one-time)

npm run auth

A browser window will open -> approve Google access -> tokens will be saved to .tokens.json. After this, re-authorization is not required because tokens are refreshed automatically.

Connect to Claude Desktop

Open claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Add:

{
  "mcpServers": {
    "google-tasks": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/google-tasks-mcp/src/index.js"]
    }
  }
}

Restart Claude Desktop -> new tools will appear in the interface.

Connect to Claude Code

claude mcp add google-tasks -- node /ABSOLUTE/PATH/TO/google-tasks-mcp/src/index.js

Connect to Cursor / Windsurf / other agents

Any agent that supports MCP (stdio transport):

{
  "mcpServers": {
    "google-tasks": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/google-tasks-mcp/src/index.js"]
    }
  }
}

Example prompts for your agent

"Show all my tasks for this week"
"Create a task 'Open PR' with deadline 2026-03-05"
"Mark task X as completed"
"Move task Y to the top of the list"

Project structure

google-tasks-mcp/
├── src/
│   ├── index.js          — MCP server (tools + handlers)
│   ├── auth.js           — OAuth2 one-time setup
│   └── tasks-api.js      — Google Tasks API wrapper
├── .credentials.json     — (gitignored) your OAuth credentials
├── .tokens.json          — (gitignored) access + refresh tokens
├── .credentials.example.json
├── .gitignore
└── package.json

Security

  • .credentials.json and .tokens.json must never be committed (already in .gitignore)
  • Tokens are refreshed automatically via the googleapis OAuth2 client

相关 MCP