Things MCP Server
Things MCP 服务器
此模型上下文协议 (MCP)服务器允许您使用 Claude Desktop 与Things 应用程序中的任务管理数据进行交互。您可以要求 Claude 创建任务、分析项目、帮助管理优先级等等。
该服务器利用Things.py库和Things URL Scheme 。
特征
访问所有主要事物列表(收件箱、今日、即将发生等)
项目和区域管理
标签操作
高级搜索功能
最近项目追踪
详细的物品信息,包括清单
支持嵌套数据(区域内的项目、项目内的待办事项)
Related MCP server: Things MCP
安装(适用于 Claude Desktop)
先决条件
Python 3.12+
克劳德桌面
Things 3(必须在“设置”->“通用”中打开“启用 Things URL”)
如果尚未安装 uv,请安装:
curl -LsSf https://astral.sh/uv/install.sh | sh然后重新启动您的终端。
克隆此存储库:
git clone https://github.com/hald/things-mcp安装所需的 Python 包:
cd things-mcp
uv venv
uv pip install -r pyproject.toml编辑Claude桌面配置文件:
code ~/Library/Application\ Support/Claude/claude_desktop_config.json将 Things 服务器添加到配置文件的 mcpServers 键中(确保更新安装这些文件的文件夹的路径):
{
"mcpServers": {
"things": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/things-mcp",
"run",
"things_server.py"
]
}
}
}重新启动 Claude 桌面应用程序。
Claude Desktop 的使用示例
“我今天的待办事项清单上有什么?”
“为下周的海滩度假制定一份打包清单,包括打包清单。”
“使用艾森豪威尔矩阵评估我当前的待办事项。”
“帮助我使用 Things 进行 GTD 风格的每周回顾。”
尖端
在 Claude 中创建一个项目,其中包含自定义说明,解释如何使用 Things 以及组织区域、项目、标签等。告诉 Claude 创建新任务时您希望包含哪些信息(例如,要求它在任务描述中包含相关详细信息可能会有所帮助)。
尝试添加另一个允许 Claude 访问您日历的 MCP 服务器。这样您就可以让 Claude 在日历上为特定任务预留时间,根据即将发生的日历事件(例如会议准备)创建待办事项等等。
可用工具
列表视图
get-inbox- 从收件箱获取待办事项get-today- 获取今天到期的待办事项get-upcoming- 获取即将发生的待办事项get-anytime- 从 Anytime 列表中获取待办事项get-someday- 从 Someday 列表中获取待办事项get-logbook- 获取已完成的待办事项get-trash- 获取已删除的待办事项
基本操作
get-todos- 获取待办事项,可选择按项目进行过滤get-projects- 获取所有项目get-areas- 获取所有区域
标签操作
get-tags获取所有标签get-tagged-items- 获取带有特定标签的项目
搜索行动
search-todos- 按标题/注释进行简单搜索search-advanced- 具有多个过滤器的高级搜索
基于时间的操作
get-recent- 获取最近创建的项目
工具参数
待办事项
project_uuid(可选)- 按项目过滤待办事项include_items(可选,默认值:true)- 包含清单项目
获取项目/获取区域/获取标签
include_items(可选,默认值:false)- 包含所含项目
高级搜索
status- 按状态过滤(未完成/已完成/已取消)start_date- 按开始日期过滤 (YYYY-MM-DD)deadline- 按截止日期过滤(YYYY-MM-DD)tag- 按标签过滤area- 按区域 UUID 过滤type- 按项目类型过滤(待办事项/项目/标题)
获取最近
period- 时间段(例如,“3d”、“1w”、“2m”、“1y”)
故障排除
服务器包括以下错误处理:
无效的 UUID
缺少必需参数
事物数据库访问错误
数据格式错误
所有错误都会被记录下来并返回描述性消息。要从 Claude Desktop 查看 MCP 日志,请在终端中运行以下命令:
# Follow logs in real-time
tail -n 20 -f ~/Library/Logs/Claude/mcp*.logAvailable Tools
22 toolsadd_projectB
Create a new project in Things
Args: title: Title of the project notes: Notes for the project when: When to schedule the project deadline: Deadline for the project tags: Tags to apply to the project area_id: ID of area to add to area_title: Title of area to add to todos: Initial todos to create in the project
Inputs: title (required), area_id, area_title, deadline, +4 more. Returns: result
add_todoB
Create a new todo in Things
Args: title: Title of the todo notes: Notes for the todo when: When to schedule the todo (today, tomorrow, evening, anytime, someday, or YYYY-MM-DD) deadline: Deadline for the todo (YYYY-MM-DD) tags: Tags to apply to the todo checklist_items: Checklist items to add list_id: ID of project/area to add to list_title: Title of project/area to add to heading: Heading title to add under heading_id: Heading ID to add under (takes precedence over heading)
Inputs: title (required), checklist_items, deadline, heading, +6 more. Returns: result
get_anytimeC
Get todos from Anytime list
Inputs: no named parameters. Returns: result
get_areasC
Get all areas from Things
Args: include_items: Include projects and tasks within areas
Inputs: include_items. Returns: result
get_headingsC
Get headings from Things
Args: project_uuid: Optional UUID of a specific project to get headings from
Inputs: project_uuid. Returns: result
get_inboxC
Get todos from Inbox
Inputs: no named parameters. Returns: result
get_logbookA
Get completed todos from Logbook, defaults to last 7 days
Args: period: Time period to look back (e.g., '3d', '1w', '2m', '1y'). Defaults to '7d' limit: Maximum number of entries to return. Defaults to 50
Inputs: limit, period. Returns: result
get_projectsC
Get all projects from Things
Args: include_items: Include tasks within projects
Inputs: include_items. Returns: result
get_recentC
Get recently created items
Args: period: Time period (e.g., '3d', '1w', '2m', '1y')
Inputs: period (required). Returns: result
get_somedayB
Get todos from Someday list
Inputs: no named parameters. Returns: result
get_tagged_itemsC
Get items with a specific tag
Args: tag: Tag title to filter by
Inputs: tag (required). Returns: result
get_tagsC
Get all tags
Args: include_items: Include items tagged with each tag
Inputs: include_items. Returns: result
get_todayB
Get todos due today
Inputs: no named parameters. Returns: result
get_todosB
Get todos from Things, optionally filtered by project
Args: project_uuid: Optional UUID of a specific project to get todos from include_items: Include checklist items
Inputs: include_items, project_uuid. Returns: result
get_trashB
Get trashed todos
Inputs: no named parameters. Returns: result
get_upcomingB
Get upcoming todos
Inputs: no named parameters. Returns: result
search_advancedB
Advanced todo search with multiple filters
Args: status: Filter by todo status (incomplete, completed, canceled) start_date: Filter by start date (YYYY-MM-DD) deadline: Filter by deadline (YYYY-MM-DD) tag: Filter by tag area: Filter by area UUID type: Filter by item type (to-do, project, heading)
Inputs: area, deadline, start_date, status, +2 more. Returns: result
search_itemsC
Search for items in Things
Args: query: Search query
Inputs: query (required). Returns: result
search_todosC
Search todos by title or notes
Args: query: Search term to look for in todo titles and notes
Inputs: query (required). Returns: result
show_itemB
Show a specific item or list in Things
Args: id: ID of item to show, or one of: inbox, today, upcoming, anytime, someday, logbook query: Optional query to filter by filter_tags: Optional tags to filter by
Inputs: id (required), filter_tags, query. Returns: result
update_projectB
Update an existing project in Things
Args: id: ID of the project to update title: New title notes: New notes when: New schedule deadline: New deadline tags: New tags completed: Mark as completed canceled: Mark as canceled
Inputs: id (required), canceled, completed, deadline, +4 more. Returns: result
update_todoB
Update an existing todo in Things
Args: id: ID of the todo to update title: New title notes: New notes when: New schedule deadline: New deadline tags: New tags completed: Mark as completed canceled: Mark as canceled list: The title of a project or area to move the to-do into list_id: The ID of a project or area to move the to-do into (takes precedence over list) heading: The heading title to move the to-do under heading_id: The heading ID to move the to-do under (takes precedence over heading)
Inputs: id (required), canceled, completed, deadline, +8 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 22 tools
Most tools have distinct purposes targeting specific resources like projects, todos, areas, or lists, with clear separation between creation, retrieval, and update operations. However, there is some overlap between search_items, search_todos, and search_advanced, which could cause confusion about which to use for different search scenarios.
Tool names follow a highly consistent verb_noun pattern throughout, with verbs like add, get, update, and search paired with specific nouns (e.g., add_project, get_areas, update_todo, search_items). All names use snake_case uniformly, making the set predictable and easy to navigate.
With 22 tools, the count is on the higher side for a task management server, bordering on heavy. While many tools serve distinct functions, the number might feel overwhelming compared to a more streamlined set, though it's not extreme given the domain's complexity.
The tool set provides comprehensive coverage for task management, including full CRUD operations for projects and todos, retrieval of various lists (e.g., inbox, today, upcoming), search capabilities, and management of related entities like areas, tags, and headings. No obvious gaps exist for core workflows.
Maintenance
Related MCP Connectors
Capture, clarify and plan your tasks from Claude or ChatGPT. Built around the GTD methodology.
Manage Redbooth tasks, task lists, comments, tags and files from Claude and other AI assistants.
Notes and actions in one app. Let Claude or ChatGPT read and update them.
Notes, tasks, habits, journal and 6 more tools Claude can read and change, with undo. Free.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceLets you use Claude Desktop to interact with your task management data in Things app, enabling you to create tasks, analyze projects, manage priorities, and implement productivity workflows through natural language.35MIT
- FlicenseBqualityDmaintenanceEnables 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.2016-
- AlicenseBqualityDmaintenanceEnables Claude to interact with Things 3 task management, allowing creation, analysis, and management of tasks, projects, and tags via natural language.22MIT
- AlicenseBqualityDmaintenanceEnables Claude to interact with Things 3 task management, allowing natural language task creation, project analysis, and GTD workflow automation.2473 PyPI44MIT