Things Safe MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Things Safe MCP Show my tasks due today in the Anytime list"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Things Safe MCP
An unofficial MCP server for Things 3 that uses only integration methods Cultured Code documents as safe:
AppleScript for reads and normal task edits.
The Things URL scheme for checklist edits.
It never reads or writes the Things database, app-support files, or Things Cloud credentials. It is macOS-only and requires Things 3.
Install
Install uv, then register the server with your MCP client. For Codex:
codex mcp add things -- uvx --from git+https://github.com/jasongibby/things-safe-mcp things-safe-mcpFor another stdio MCP client, use:
{
"mcpServers": {
"things": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/jasongibby/things-safe-mcp",
"things-safe-mcp"
]
}
}
}Start Things once before the first request. macOS will ask for permission for your MCP host to automate Things.
Related MCP server: Things MCP Server
Checklist token
Only checklist edits need a Things URL authorization token. In Things, open
Settings → General → Enable Things URLs → Manage, generate a token, and
provide it to the server as THINGS_AUTH_TOKEN through your MCP client's secure
environment configuration. Do not commit or share it.
All other operations work without a token.
Tools
Read Inbox, Today, Upcoming, Anytime, Someday, projects, project tasks, and directly tagged tasks.
Search task titles and notes.
Create tasks.
Edit titles, notes, tags, status, schedule, and project assignment. Pass an empty project ID to detach a task.
Replace, append, or prepend checklist items.
Safety and privacy
Cultured Code lists AppleScript and the Things URL scheme as safe connection methods. This server passes user input as process arguments rather than interpolating it into AppleScript source.
Your MCP client and AI provider can see task data returned by the server. Review their privacy policies before use. This project is not affiliated with or endorsed by Cultured Code.
Development
uv sync
uv run python -m unittest discover -s tests -vTests mock all external processes and never access Things.
License
MIT
Available Tools
12 toolsadd_todoC
Create a task through Things' supported AppleScript interface.
Inputs: title (required), tags, when, notes, +1 more. Returns: result
get_anytimeA
Get Anytime tasks using Things' official AppleScript API.
Inputs: no named parameters. Returns: result
get_inboxB
Get Inbox tasks using Things' official AppleScript API.
Inputs: no named parameters. Returns: result
get_projectsA
List all Things projects, including their stable Things IDs.
Inputs: no named parameters. Returns: result
get_somedayB
Get Someday tasks using Things' official AppleScript API.
Inputs: no named parameters. Returns: result
get_tagged_itemsC
Get tasks with a directly applied tag.
Inputs: tag (required). Returns: result
get_todayB
Get Today tasks using Things' official AppleScript API.
Inputs: no named parameters. Returns: result
get_todosA
Get a project's tasks by its Things ID.
Inputs: project_uuid (required). Returns: result
get_upcomingB
Get Upcoming tasks using Things' official AppleScript API.
Inputs: no named parameters. Returns: result
search_todosB
Search task titles and notes without direct database access.
Inputs: query (required). Returns: result
update_checklistC
Change a checklist via the documented URL scheme; needs THINGS_AUTH_TOKEN.
Inputs: id (required), checklist_items (required), mode. Returns: result
update_todoC
Edit a task. Pass project_id="" to detach it from its project.
Inputs: id (required), tags, when, notes, +3 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 12 tools
Each tool targets a distinct resource or view: separate list views (inbox, today, upcoming, anytime, someday), project tasks, projects, search, tags, and CRUD operations. No two tools overlap in purpose, and the descriptions clearly differentiate them.
All tools follow a consistent verb_noun pattern in snake_case (e.g., get_inbox, add_todo, update_checklist). The verbs are limited to get, search, add, and update, and nouns clearly indicate the target entity, making the naming predictable and uniform.
12 tools is well within the typical 3-15 range for a focused server. Each tool covers a distinct feature of the Things app, and there is no redundancy or bloat; the count feels proportional to the domain's complexity.
The set covers viewing multiple lists, projects, search, tags, and adding/updating todos and checklists, but misses common lifecycle operations like deleting or completing todos, and does not provide project creation or deletion. These are notable gaps for a task management server, though most core workflows are supported.
Maintenance
Related MCP Connectors
Local-first task manager: create, edit, and complete tasks, projects, and checklists via MCP.
Read teams, spaces, lists and tasks; create, update and comment on tasks and track time.
Read and write your MustDo (iOS alarm To-Do) tasks in your own iCloud via CloudKit.
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
Related MCP Servers
- AlicenseAqualityDmaintenanceIntegrates with Things 3 task management app on macOS via URL schemes, enabling creation, updating, deletion of todos and projects, navigation, search, and JSON batch imports.1024 npmMIT
- AlicenseBqualityDmaintenanceEnables Claude to interact with Things 3 task management, allowing creation, analysis, and management of tasks, projects, and tags via natural language.22MIT
- AlicenseAqualityBmaintenanceEnables AI agents to read and write to-dos, lists, areas, and projects in Things 3 on macOS via AppleScript, allowing task management workflows like triaging, logging, and rescheduling.14MIT
- AlicenseAqualityBmaintenanceEnables MCP clients to manage Things 3 tasks locally on macOS, including searching, creating, editing, scheduling, moving, completing, and trashing tasks through supported automation interfaces.2014MIT