This Model Context Protocol (MCP) server lets you use Claude Desktop to interact with your task management data in Things 3 from Cultured Code. You can ask Claude to create tasks, analyze projects…
things-mcp is an MCP project maintained in the hald/things-mcp repository. The maintainer describes its purpose as “This Model Context Protocol (MCP) server lets you use Claude Desktop to interact with your task management data in Things 3 from Cultured Code. You…”. Read the project documentation for the complete scope.
The documented pypi package is things-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.
Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| get-inbox | Get todos from Inbox |
| get-today | Get todos due today |
| get-upcoming | Get upcoming todos |
| get-anytime | Get todos from Anytime list |
| get-someday | Get todos from Someday list, including tasks in Someday projects |
| get-logbook | Get completed todos |
| get-trash | Get trashed todos |
| get-todos | Get todos, optionally filtered by project |
| get-projects | Get all projects |
| get-areas | Get all areas |
| get-tags | Get all tags |
| get-tagged-items | Get items with a specific tag |
| get-tag-usage | Report how many items use each tag, sorted by usage; flag unused tags for cleanup |
| search-todos | Simple search by title/notes |
| search-advanced | Advanced search with multiple filters |
| get-recent | Get recently created items |
| add-todo | Create a new todo |
| add-project | Create a new project |
| add-area | Create a new Area (via AppleScript; Things URL scheme has no add-area command) |
| update-area | Update an existing Area: rename or set tags (via AppleScript) |
| update-todo | Update an existing todo |
| bulk-update-todos | Apply the same update to many todos in a single operation |
| update-project | Update an existing project |
| show-item | Show a specific item or list in Things |
| search-items | Search for items in Things |
| limit | optional, default: 50) - Maximum number of completed items to return |
| offset | Number of items to skip from the start (default: 0) |
| project_uuid | optional) - Filter todos by project |
| include_items | optional, default: false) - Include contained items |
| status | Filter by status (incomplete/completed/canceled) |
| start_date | Filter by start date (YYYY-MM-DD) |
| deadline | Set deadline on all (YYYY-MM-DD) |
| tag | Filter by tag |
| area | Filter by area UUID |
| last | Filter by creation date (e.g., '3d' for last 3 days, '1w' for last week) |
| period | optional, default: '7d') - Look-back window by completion date. Accepts d/w/m/y (e.g., '3d', '1w', '2m', '1y'); months ≈ 30 days, years ≈ 365 days |
| only_unused | optional, default: false) - Return only tags that no item references (cleanup candidates) |
| tags | Replace all tags on the todo |
| add_tags | Append tags without removing existing ones |
| checklist_items | Replace the entire checklist with this list |
| prepend_checklist_items | Add these items to the top of the checklist |
| append_checklist_items | Add these items to the bottom of the checklist |
| ids | required) - List of todo UUIDs to update |
| when | Accepts multiple formats: |
| Keywords | today, tomorrow, evening, anytime, someday |
| Date | YYYY-MM-DD (e.g., 2024-01-15) |
{
"mcpServers": {
"things": {
"command": "uvx",
"args": [
"things-mcp"
]
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
Store entities, relations and observations in a local knowledge graph with the reference Memory MCP server.
Connect the Notion MCP server to search workspace content and work with pages and databases through Notion’s hosted OAuth service.
Search Linear issues and projects, inspect work context and manage updates through Linear’s hosted MCP server with OAuth.
Your assistant inside the workspace — read channels, search history, post messages and tame the noise.
Metabase ships its own MCP endpoint — search your BI content, build and run queries, and save questions and dashboards without leaving the chat.
Stop letting your assistant hallucinate n8n node parameters — this server hands it the real schemas, templates and validation.