
Things
The Things MCP server enables Claude to interact with Cultured Code's Things 3 task management application on macOS by providing access to lists (Inbox, Today, Upcoming), projects, areas, tags, and search capabilities. It leverages the Things.py library and URL scheme to allow users to create tasks, analyze projects, manage priorities, and conduct productivity reviews through natural language conversation. This integration solves the problem of bridging Claude's capabilities with Things 3 data, enabling AI-assisted task management and productivity analysis without leaving the Claude interface.
- GitHub stars
- 467
- tools
- 25
- last updated
- Jan 31, 2026
Tools
25 toolsPublic tool metadata for what this MCP can expose to an agent.
get-inboxGet todos from Inbox
Get todos from Inbox
No parameter schema in public metadata yet.
get-todayGet todos due today
Get todos due today
No parameter schema in public metadata yet.
get-upcomingGet upcoming todos
Get upcoming todos
No parameter schema in public metadata yet.
get-anytimeGet todos from Anytime list
Get todos from Anytime list
No parameter schema in public metadata yet.
get-somedayGet todos from Someday list, including tasks in Someday projects
Get todos from Someday list, including tasks in Someday projects
No parameter schema in public metadata yet.
get-logbookGet completed and canceled todos, optionally for one project
Get completed and canceled todos, optionally for one project
No parameter schema in public metadata yet.
get-trashGet trashed todos
Get trashed todos
No parameter schema in public metadata yet.
get-todosGet todos, optionally filtered by project
Get todos, optionally filtered by project
No parameter schema in public metadata yet.
get-projectsGet all projects
Get all projects
No parameter schema in public metadata yet.
get-areasGet all areas
Get all areas
No parameter schema in public metadata yet.
get-tagsGet all tags
Get all tags
No parameter schema in public metadata yet.
get-tagged-itemsGet items with a specific tag
Get items with a specific tag
No parameter schema in public metadata yet.
get-tag-usageReport how many items use each tag, sorted by usage; flag unused tags for cleanup
Report how many items use each tag, sorted by usage; flag unused tags for cleanup
No parameter schema in public metadata yet.
search-todosSimple search by title/notes
Simple search by title/notes
No parameter schema in public metadata yet.
search-advancedAdvanced search with multiple filters
Advanced search with multiple filters
No parameter schema in public metadata yet.
get-recentGet open items created within a rolling time window
Get open items created within a rolling time window
No parameter schema in public metadata yet.
add-todoCreate a new todo
Create a new todo
No parameter schema in public metadata yet.
add-projectCreate a new project
Create a new project
No parameter schema in public metadata yet.
add-areaCreate a new Area (via AppleScript; Things URL scheme has no add-area command)
Create a new Area (via AppleScript; Things URL scheme has no add-area command)
No parameter schema in public metadata yet.
update-areaUpdate an existing Area: rename or set tags (via AppleScript)
Update an existing Area: rename or set tags (via AppleScript)
No parameter schema in public metadata yet.
update-todoUpdate an existing todo
Update an existing todo
No parameter schema in public metadata yet.
bulk-update-todosApply the same update to many todos in a single operation
Apply the same update to many todos in a single operation
No parameter schema in public metadata yet.
update-projectUpdate an existing project
Update an existing project
No parameter schema in public metadata yet.
show-itemShow a specific item or list in Things
Show a specific item or list in Things
No parameter schema in public metadata yet.
search-itemsSearch for items in Things
Search for items in Things
No parameter schema in public metadata yet.
Sponsors
Readme
Things MCP Server
This Model Context Protocol (MCP) server lets you use ChatGPT, Codex, Claude Desktop, and other MCP clients to interact with your task management data in Things 3 from Cultured Code. You can ask your assistant to create tasks, analyze projects, help manage priorities, and more.
This server leverages the Things.py library and the Things URL Scheme.
Support the Project
If you find this project helpful, consider supporting its development:
Features
- Access to all major Things lists (Inbox, Today, Upcoming, etc.)
- Project and area management
- Tag operations
- Advanced search capabilities
- Recent items
- Detailed item information including checklists
- Support for nested data (projects within areas, todos within projects)
- Someday project filtering: tasks in Someday projects are automatically excluded from Today, Upcoming, and Anytime views, matching Things UI behavior
Installation
Details
- Repository
- github.com/hald/things-mcp
- Categories
- Data & Analytics, Productivity & Office