AI导哈

任务管理服务器

TickTick MCP服务器是一个任务管理服务，支持AI助手如Claude管理任务，包括创建、更新、完成和删除任务等功能。

  • by AdityaKhandelwal10
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 AdityaKhandelwal10/ticktick-mcp-server

使用说明

TickTick MCP服务器

用于TickTick任务管理的MCP服务器-使Claude等AI助手能够管理您的任务。

特性

核心任务管理

  • ✅ 列出项目和任务
  • ✅ 创建新任务
  • ✅ 更新任务（标题、内容、优先级、截止日期）
  • ✅ 完成任务
  • ✅ 删除任务

高级功能

  • ✅ 按关键字搜索任务
  • ✅ 获取今天到期的任务
  • ✅ 获取过期任务
  • ✅ 按优先级筛选任务
  • ✅ 标签管理（列出标签，为任务添加标签）
  • ✅ 创建新项目

认证

  • ✅ 带有自动令牌刷新的OAuth2身份验证

设置

1.获取TickTick API凭证

  1. 首选 TickTick开发者门户
  2. 创建新应用程序
  3. 将重定向URI设置为： http://localhost:8080/callback
  4. 保存您的 Client ID 和 Client Secret

2.安装软件包

cd tick-tick-mcp
pip install -r requirements.txt
# or
pip install -e .

2.5.创建.env文件（用于本地测试）

cp .env.example .env

编辑 .env 并添加您的凭据：

TICKTICK_CLIENT_ID=your-actual-client-id
TICKTICK_CLIENT_SECRET=your-actual-client-secret

3.配置克劳德桌面

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "ticktick": {
      "command": "python",
      "args": ["-m", "ticktick_mcp"],
      "env": {
        "TICKTICK_CLIENT_ID": "your-client-id-here",
        "TICKTICK_CLIENT_SECRET": "your-client-secret-here"
      }
    }
  }
}

4.配置光标（可选）

对于Cursor IDE，将相同的配置添加到： ~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

5.首次使用

首次使用时，MCP服务器将：

  1. 自动打开浏览器进入TickTick授权页面
  2. 您授权应用程序
  3. 令牌会自动保存到 ~/.ticktick-mcp/tokens.json
  4. 未来请求自动刷新令牌-无需重新认证！

用法

配置后，您可以询问Claude或Cursor：

基本操作：

  • “列出我的TickTick项目”
  • “显示我的所有任务”
  • “创建一个名为“审查PR”的任务”
  • “完成任务XYZ”
  • “删除任务ABC”

高级查询：

  • “搜索有关“会议”的任务”
  • “今天有什么任务要交？”
  • “显示所有逾期任务”
  • “列出我的高优先级任务”
  • “将任务XYZ更新为高优先级”
  • “将标签‘紧急’添加到任务ABC”
  • “创建一个名为“个人”的新项目”
  • “我使用什么标签？”

可用工具（共13个）

项目管理

  • list_projects -获取所有项目
  • create_project -创建新项目/列表

任务操作

  • list_tasks -获取任务（可选按项目筛选）
  • create_task -创建新任务
  • update_task -更新任务属性（标题、内容、优先级、截止日期）
  • complete_task -标记任务完成
  • delete_task -删除任务

搜索和筛选

  • search_tasks -按关键字搜索任务
  • get_tasks_today -获取今天到期的任务
  • get_tasks_overdue -获取过期任务
  • get_tasks_by_priority -按优先级筛选（0=无，1=低，3=中，5=高）

标签

  • list_tags -列出所有标签
  • add_tag_to_task -向任务添加标签

发展

# Install in development mode
pip install -e .

# Run directly
python -m ticktick_mcp

安全

  • 令牌存储在本地 ~/.ticktick-mcp/tokens.json
  • 永远不要将您的客户端ID/密钥提交给版本控制
  • 每个用户都需要自己的TickTick开发者应用程序

许可证

麻省理工学院

相关 MCP