Things MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Things MCP Server
This is a zero-dependency bridge that allows Claude to read and manage Things 3 on your Mac.
Runs completely locally, nothing is downloaded at install
No third-party packages, only uses Node's built-in modules
Never writes to the Things database for added protection and cloud syncing
Can be connected as-is to other AI agents
Features
Feature | Description |
Create | Add new items with notes, deadlines, reminders, tags, checklists, etc. |
Read | Read any items with full details including in-item checklists, tags, project, area, heading, deadlines, and notes. |
Edit | Edit task details, reschedule, move, add or clear a deadline, edit tags, complete, or cancel a task. Can bulk edit up to 500 items at once. |
Find | Find tool allows for detailed search and filter of any items based on text, tag, status, deadline, or even a created/completed date range. |
Misc | Move to Trash (always reversible), open an item in Things app, and MCP status check. |
Related MCP server: Things MCP Server
Install
Requirements: macOS, Things 3, and the Claude desktop app (which supplies Node, so there's nothing else to install).
In Things: Settings → General → Enable Things URLs.
Download
things-local.mcpbfrom Releases, or build it yourself (see below), then double-click it and click Install in the Claude app.The first time Claude uses it, macOS asks whether Claude may control Things, and later whether it may access data from other apps (for checklists, headings and search). Allow both.
Optional: auth token
Without it, everything works except evening/reminder times, checklist edits, heading moves, deadline clearing and duplicating on existing items (Things requires its token for those). To add it, go to Things → Settings → General → Enable Things URLs → Manage, copy the token, then paste it into Claude → Settings → Extensions → Things (Local) and save.
Then install a newer version of the extension. The Claude app only applies a saved token on install or update, so restarting isn't enough. To confirm, ask Claude to run the status tool, which reports whether the token arrived without showing it.
Limitations
macOS only, as Things' automation interfaces are Mac-only.
Some edits to existing items need the auth token (above).
Checklist and heading reading depends on Things' database layout, which Cultured Code doesn't document or guarantee.
Things doesn't return an ID when an item is created by URL, so the server confirms new items by reading them back by title. If two identical titles are created within a few minutes, it reports the newest.
Development
npm test # 26 offline test groups; no Mac or Things needed (Node 22.5+)
npm run pack # builds things-local.mcpb with Anthropic's official packagerThe tests cover the MCP protocol, the syntax of every script sent to Apple's engine, read/write logic against a simulated Things object model, URL encoding with hostile input, the read-only database layer, and a regression test for each bug in the changelog.
License
MIT. See LICENSE.
Unofficial. Not affiliated with or endorsed by Cultured Code. "Things" is a trademark of Cultured Code GmbH & Co. KG.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Lets Claude, ChatGPT, and Muse read and update your beckett tasks, notes, calendar, and lists.
Capture, clarify and plan your tasks from Claude or ChatGPT. Built around the GTD methodology.
1Manage 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.
Related MCP Servers
- 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
- AlicenseBqualityDmaintenanceEnables Claude to interact with Things 3 task management, allowing natural language task creation, project analysis, and GTD workflow automation.2473 PyPI44MIT
- AlicenseBqualityDmaintenanceEnables Claude to interact with task management data in the Things app, including creating tasks, managing projects, searching, and organizing priorities.211MIT