使用说明

项目简介

TickTick MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，它将您的 TickTick 任务管理系统与支持 MCP 协议的 LLM 客户端（如 Claude）连接起来。通过此服务器，您可以使用自然语言直接与您的 TickTick 任务和项目进行交互。

主要功能点

查看：列出您的所有 TickTick 项目和任务。
创建：通过自然语言创建新的项目和任务。
更新：修改现有任务的详细信息，如标题、内容、日期和优先级。
完成：标记任务为已完成。
删除：删除任务和项目。
集成：无缝集成 Claude for Desktop 等 MCP 客户端。

安装步骤

克隆仓库

git clone https://github.com/jacepark12/ticktick-mcp.git
cd ticktick-mcp

安装依赖 确保您已安装 Python 3.10 或更高版本，并按照仓库 README.md 中的指引安装 'uv'。然后创建虚拟环境并安装项目依赖：

uv venv
source .venv/bin/activate  # macOS/Linux
# .venv\Scripts\activate  # Windows
uv pip install -e .

TickTick 认证 注册 TickTick API 应用并获取 Client ID 和 Client Secret，然后运行认证命令：
```
uv run -m ticktick_mcp.cli auth
```
按照提示完成 TickTick 账户的授权。
测试配置 运行测试脚本验证 TickTick 连接是否正常：
```
uv run test_server.py
```

服务器配置

要将 Claude for Desktop 连接到 TickTick MCP Server，请编辑 Claude 的配置文件 'claude_desktop_config.json'，并添加以下服务器配置：

{
   "mcpServers": {
      "ticktick": {
         "serverName": "ticktick",
         "command": "<uv 可执行文件的绝对路径>",
         "args": ["run", "--directory", "<ticktick-mcp 仓库目录的绝对路径>", "-m", "ticktick_mcp.cli", "run"]
      }
   }
}

配置参数说明：

'serverName': 服务器名称，此处设置为 "ticktick"。
'command': 'uv' 可执行文件的绝对路径。请替换为您的 'uv' 命令的实际路径。
'args': 启动服务器的参数列表。
- '"run"': uv 的 run 命令。
- '"--directory"': 指定工作目录为 ticktick-mcp 仓库目录。请替换为您的 'ticktick-mcp' 仓库的绝对路径。
- '"-m"': 运行 Python 模块。
- '"ticktick_mcp.cli"': 指定要运行的模块为 'ticktick_mcp.cli' (命令行接口)。
- '"run"': 指定 'ticktick_mcp.cli' 的子命令为 'run' (启动服务器)。

请根据您的实际环境替换 '<uv 可执行文件的绝对路径>' 和 '<ticktick-mcp 仓库目录的绝对路径>'。

基本使用方法

配置完成后，重启 Claude for Desktop。您将在 Claude 中看到可用的 TickTick 工具（🔨 图标标识）。即可使用自然语言指令与您的 TickTick 数据进行交互，例如：

"显示我所有的 TickTick 项目"
"在我的工作项目下创建一个名为 '完成 MCP 服务器文档' 的高优先级任务"
"列出我的个人项目中的所有任务"
"将 '购买杂货' 任务标记为完成"

关键词