About Things MCP
Things MCP is an MCP server published by mgomes in the Developer Tools category: stdio MCP server for the Things macOS app.
The repository has 3 stars and 0 forks, with the last commit 28 days ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/mgomes/things-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (8)
things-addcreate todos (supports multi-title batches, tags, deadlines, etc.)
Parameters not published.
things-add-projectcreate projects with optional child todos and metadata
Parameters not published.
things-jsoninvoke the JSON batch command for complex imports
Parameters not published.
things-searchopen the search UI with optional query text
Parameters not published.
things-showreveal a list/project/todo or quick find query
Parameters not published.
things-updateupdate existing todos (requires Things auth token)
Parameters not published.
things-update-projectupdate existing projects (requires auth token)
Parameters not published.
things-versionshow the Things build/scheme version dialog
Parameters not published.
Ask AI
Ask AI about Things MCP
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 6 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- !License declaredNo license file. Legally you have no right to use it in a product.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
Things MCP
An MCP server for Things on macOS. Agents read and edit your tasks through Things' AppleScript interface.
Any client connected to this server can change your tasks. Only give it to agents you trust.
Requirements
- macOS with Things 3
- Rust 1.85+
Install
cargo install --git https://github.com/mgomes/things-mcp
This puts things-mcp in ~/.cargo/bin. GUI apps may not see that path, so use the absolute path (which things-mcp) in JSON configs.
The first call asks macOS to let your agent's app control Things. Allow it. The server never brings Things to the front.
Add to your agent
Claude Code
claude mcp add -s user things -- things-mcp
Codex
codex mcp add things -- things-mcp
Gemini CLI
gemini mcp add -s user things things-mcp
VS Code
code --add-mcp '{"name":"things","command":"things-mcp"}'
Cursor, Claude Desktop, and other JSON configs
Add to ~/.cursor/mcp.json, ~/Library/Application Support/Claude/claude_desktop_config.json, or your client's equivalent:
{
"mcpServers": {
"things": {
"command": "/Users/you/.cargo/bin/things-mcp"
}
}
}
Tools
| Tool | Does |
|---|---|
things-todos |
List to-dos in a built-in list, project, area, or tag |
things-search |
Find to-dos by title or notes |
things-get |
Get a to-do or project by ID |
things-projects |
List projects |
things-areas |
List areas |
things-tags |
List tags |
things-add |
Create a to-do |
things-add-project |
Create a project, optionally with to-dos |
things-update |
Edit, move, schedule, complete, or cancel a to-do or project |
things-delete |
Move a to-do or project to the Trash |
things-show |
Navigate the Things window to an item or list |
Everything returns JSON with IDs. Tools are annotated read-only or destructive so agents can auto-approve reads.
Limitations
Things' AppleScript interface doesn't expose checklist items, headings, This Evening, or reminder times.
Development
just test
just build
just install
README fetched from the repository 6 days ago. The original is authoritative.