# Install the extended version globally
npm install -g @kydycode/todoist-mcp-server-ext@latest
# Then use in Claude Desktop config
{
"mcpServers": {
"todoist-mcp-server": {
"command": "todoist-mcp-server-ext",
"env": {
"TODOIST_API_TOKEN": "your_api_token_here"
}
}
}
}
📖 使用示例
🎯 高级任务创建和管理
"Create task 'Team Meeting @Tomorrow #Work p1'"
"Add task 'Fix critical bug +KydyCode @DevProject L:Urgent L:Backend'"
"Quick add: 'Buy milk tomorrow at 2pm #shopping !p1'"
"Move task with ID {task_id} to project {project_id}"
"Search tasks: search: API deployment"
🗂️ 项目、部门、标签和评论管理
"List all my projects"
"Create project 'Q2 Planning' color:blue favorite:true view:board"
"Get sections for project {project_id}"
"Create label 'HighPriority' color:red isFavorite:true"
"List all labels"
"Add comment 'Great progress on this task!' to task {task_id}"
"Get all comments for project {project_id}"
"Update comment {comment_id} with new content"
✅ 已完成任务历史记录🆕
"Get completed tasks between 2024-01-01 and 2024-01-31"
"Show tasks completed since 2024-01-01 until today"
"Get completed tasks from project {project_id} since 2024-01-01 until 2024-12-31"
"Show last week's completed tasks"
src/
├── index.ts # Main server implementation with all tools
package.json # Dependencies and scripts
tsconfig.json # TypeScript configuration
README.md # This file
local-instructions.md # Personal publishing guide
LICENSE
.gitignore
dist/ # Compiled JavaScript output (after `npm run build`)
├── index.js
└── index.d.ts
从源头构建
# Install dependencies
npm install
# Build TypeScript
npm run build
# Test the server (requires TODOIST_API_TOKEN)
# Example: Set token and pipe a list tools request
export TODOIST_API_TOKEN="your_actual_todoist_api_token"
echo '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}' | node dist/index.js
开发脚本
npm run build # Compile TypeScript and make output executable
npm run watch # Watch for changes and rebuild (doesn't make output executable)
npm run prepare # Pre-publish build (runs build)