Things MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Things MCP Server add a todo for tomorrow: call mom about birthday plans"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Things MCP Server
一个用于通过URL Scheme与Things 3任务管理应用集成的MCP(Model Context Protocol)服务器。
功能特性
✅ 创建/更新/删除待办事项和项目
✅ 导航和搜索
✅ JSON批量导入
Related MCP server: Things 3 MCP Server
快速开始
1. 获取授权令牌
打开Things应用:Things → Settings → General → Enable Things URLs → Manage
2. 配置Claude Code MCP
在终端运行以下命令:
# 设置环境变量
export THINGS_AUTH_TOKEN="你的授权令牌"
# 添加 MCP 服务器
claude mcp add things --command "npx" --args "-y" "@moguw/things_mcp" --env "THINGS_AUTH_TOKEN=$THINGS_AUTH_TOKEN"或者手动编辑配置文件:
macOS: /Library/Application Support/ClaudeCode/managed-mcp.json
{
"mcpServers": {
"things": {
"command": "npx",
"args": ["-y", "@moguw/things_mcp"],
"env": {
"THINGS_AUTH_TOKEN": "你的授权令牌"
}
}
}
}3. 重启Claude Code(如果需要)
使用示例
在Claude Code中直接对话即可:
"帮我在Things中创建一个待办事项:明天给妈妈打电话"
"创建一个'学习Python'的项目"
"把ID为XXX的任务改为明天完成,并添加'紧急'标签"
"删除ID为XXX的待办事项"可用工具
工具 | 说明 | 是否需要令牌 |
| 创建待办事项 | ❌ |
| 创建项目 | ❌ |
| 更新待办事项 | ✅ |
| 更新项目 | ✅ |
| 删除待办事项 | ✅ |
| 删除项目 | ✅ |
| 导航到指定列表/项目 | ❌ |
| 搜索 | ❌ |
| JSON批量导入 | 视情况 |
| 获取版本信息 | ❌ |
详细参数说明请参考 things_url.md
系统要求
macOS (必需 - MCP服务器使用macOS专属的
open命令)Node.js >= 18.0.0
Things 3 for Mac 应用
注:虽然Things 3同时支持macOS和iOS,但此MCP服务器仅能在macOS上运行
开发
# 从源码运行
git clone https://github.com/moguw/things_mcp.git
cd things-mcp
npm install
npm run dev
# 测试
npm test许可证
MIT
Available Tools
10 toolsadd_projectC
创建新的项目。支持标题、备注、区域、标签、子任务等。
Inputs: title, notes, when, deadline, +7 more.
add_todoC
创建新的待办事项。支持标题、备注、标签、清单、截止日期等。
Inputs: title, titles, notes, when, +10 more.
delete_projectC
删除项目(通过将其标记为已取消)。需要提供项目ID和授权令牌。
Inputs: id (required), authToken.
delete_todoC
删除待办事项(通过将其标记为已取消)。需要提供待办事项ID和授权令牌。
Inputs: id (required), authToken.
get_versionB
获取Things应用和URL Scheme的版本信息。
Inputs: no named parameters.
json_importC
JSON批量导入待办事项和项目。支持复杂的嵌套结构。
Inputs: data (required), authToken, reveal.
searchC
搜索Things中的待办事项、项目等。
Inputs: query.
showC
导航到并显示区域、项目、标签、待办事项或内置列表。
Inputs: id, query, filter.
update_projectC
更新现有的项目。需要提供项目ID和授权令牌。
Inputs: id (required), authToken, title, notes, +11 more.
update_todoC
更新现有的待办事项。需要提供待办事项ID和授权令牌。
Inputs: id (required), authToken, title, notes, +12 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each tool has a clearly distinct purpose with no ambiguity: add/delete/update operations are separated for projects and todos, while search, show, json_import, and get_version serve unique functions. The descriptions clearly differentiate between resource types and actions, making tool selection straightforward.
All tool names follow a consistent verb_noun pattern using snake_case (e.g., add_project, delete_todo, update_project). The naming is uniform across all 10 tools, with verbs like add, delete, update, get, json_import, search, and show applied predictably to nouns like project, todo, and version.
With 10 tools, the count is well-scoped for a Things MCP server covering project and todo management. Each tool earns its place by providing essential CRUD operations, search, display, import, and version checking, without unnecessary bloat or missing core functionality.
The tool set offers complete CRUD/lifecycle coverage for projects and todos (add, delete, update), plus search, display, batch import, and version info. There are no obvious gaps; agents can fully manage the domain without dead ends, supporting all typical workflows from creation to deletion.
Related MCP Connectors
Add items to your tidee workspace from ordinary language, read what is there, and mark things done.
List, add, start, complete or cancel todos, undo merges, review your week, and search past work.
Read and update your Nirvana tasks and projects: GTD states, tags, due dates, and capture.
Search, read and create Linear issues, projects, teams and cycles.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables integration with Things3, allowing the creation and management of tasks and projects via the MCP protocol, including synchronization with Agenda projects.76-
- AlicenseNot gradedqualityDmaintenanceEnables LLMs to interact with Things 3 task manager on macOS via AppleScript, allowing users to list and create todos across different lists through natural language.20 npmMIT
- AlicenseBqualityDmaintenanceEnables Claude to interact with Things 3 on macOS, allowing users to create, update, and manage to-dos and projects, list tasks, search items, and navigate through Things lists using natural language.2012 npm16ISC
- AlicenseBqualityDmaintenanceEnables Claude to interact with Things 3 task management, allowing creation, analysis, and management of tasks, projects, and tags via natural language.22MIT