MCP 服务器

ticktick-mcp-server

一个 TickTick 的 MCP 服务器，可以通过 Claude 和其他 MCP 客户端直接与您的 TickTick 任务管理系统进行交互。

笔记

日历管理

访问服务器

README

TickTick MCP 服务器

一个用于 TickTick 的模型上下文协议 (MCP) 服务器，它允许直接通过 Claude 和其他 MCP 客户端与您的 TickTick 任务管理系统进行交互。

功能

📋 查看您的所有 TickTick 项目和任务
✏️ 通过自然语言创建新项目和任务
🔄 更新现有任务的详细信息（标题、内容、日期、优先级）
✅ 将任务标记为完成
🗑️ 删除任务和项目
🔄 与 TickTick 的开放 API 完全集成
🔌 与 Claude 和其他 MCP 客户端无缝集成

前提条件

Python 3.10 或更高版本
uv - 快速的 Python 包安装程序和解析器
具有 API 访问权限的 TickTick 帐户
TickTick API 凭据（客户端 ID、客户端密钥、访问令牌）

安装

克隆此存储库:

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

使用 uv 安装:

# 如果您还没有 uv，请安装它
curl -LsSf https://astral.sh/uv/install.sh | sh

# 创建一个虚拟环境
uv venv

# 激活虚拟环境
# 在 macOS/Linux 上:
source .venv/bin/activate
# 在 Windows 上:
.venv\Scripts\activate

# 安装包
uv pip install -e .

使用 TickTick 进行身份验证:
```
# 运行身份验证流程
uv run -m ticktick_mcp.cli auth
```
这将:
- 要求您提供 TickTick 客户端 ID 和客户端密钥
- 打开一个浏览器窗口，供您登录 TickTick
- 自动将您的访问令牌保存到 .env 文件
测试您的配置:
```
uv run test_server.py
```
这将验证您的 TickTick 凭据是否正常工作。

使用 TickTick 进行身份验证

此服务器使用 OAuth2 与 TickTick 进行身份验证。设置过程很简单：

在 TickTick 开发者中心注册您的应用程序
- 将重定向 URI 设置为 http://localhost:8000/callback
- 记下您的客户端 ID 和客户端密钥
运行身份验证命令：
```
uv run -m ticktick_mcp.cli auth
```
按照提示输入您的客户端 ID 和客户端密钥
将打开一个浏览器窗口，供您使用您的 TickTick 帐户授权该应用程序
授权后，您将被重定向回应用程序，并且您的访问令牌将自动保存到 .env 文件中

服务器会自动处理令牌刷新，因此除非您撤销访问权限或删除 .env 文件，否则您无需重新进行身份验证。

与 Claude for Desktop 一起使用

安装 Claude for Desktop

编辑您的 Claude for Desktop 配置文件：

macOS:

nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows:

notepad %APPDATA%\Claude\claude_desktop_config.json

添加 TickTick MCP 服务器配置，使用绝对路径：

{
   "mcpServers": {
      "ticktick": {
         "command": "<uv 的绝对路径>",
         "args": ["run", "--directory", "<ticktick-mcp 目录的绝对路径>", "-m", "ticktick_mcp.cli", "run"]
      }
   }
}

重新启动 Claude for Desktop

连接后，您将在 Claude 中看到 TickTick MCP 服务器工具，由 🔨（工具）图标指示。

可用的 MCP 工具

工具	描述	参数
`get_projects`	列出您的所有 TickTick 项目	无
`get_project`	获取有关特定项目的详细信息	`project_id`
`get_project_tasks`	列出项目中的所有任务	`project_id`
`get_task`	获取有关特定任务的详细信息	`project_id`, `task_id`
`create_task`	创建一个新任务	`title`, `project_id`, `content` (可选), `start_date` (可选), `due_date` (可选), `priority` (可选)
`update_task`	更新现有任务	`task_id`, `project_id`, `title` (可选), `content` (可选), `start_date` (可选), `due_date` (可选), `priority` (可选)
`complete_task`	将任务标记为完成	`project_id`, `task_id`
`delete_task`	删除任务	`project_id`, `task_id`
`create_project`	创建一个新项目	`name`, `color` (可选), `view_mode` (可选)
`delete_project`	删除项目	`project_id`

Claude 的示例提示

以下是一些在连接 TickTick MCP 服务器后与 Claude 一起使用的示例提示：

"显示我的所有 TickTick 项目"
"在我的工作项目中创建一个名为 '完成 MCP 服务器文档' 的新任务，并具有高优先级"
"列出我的个人项目中的所有任务"
"将任务 '购买杂货' 标记为完成"
"创建一个名为 '假期计划' 的新项目，颜色为蓝色"
"我在 TickTick 中的下一个截止日期是什么时候？"

开发

项目结构

ticktick-mcp/
├── .env.template          # 环境变量的模板
├── README.md              # 项目文档
├── requirements.txt       # 项目依赖项
├── setup.py               # 包设置文件
├── test_server.py         # 服务器配置的测试脚本
└── ticktick_mcp/          # 主包
    ├── __init__.py        # 包初始化
    ├── authenticate.py    # OAuth 身份验证实用程序
    ├── cli.py             # 命令行界面
    └── src/               # 源代码
        ├── __init__.py    # 模块初始化
        ├── auth.py        # OAuth 身份验证实现
        ├── server.py      # MCP 服务器实现
        └── ticktick_client.py  # TickTick API 客户端