Things MCP

Find and manage Things 3 tasks from a conversation.

macOS · Things 3 · 20 tools · Read-only by default

Download the extension · Documentation · Daily use · Get help

Things MCP connects compatible MCP clients to the Things app on your Mac through its supported automation interfaces. Manage tasks, projects, areas and tags. Create checklists and project templates, set reminders, duplicate items and move projects with descendant summaries. The bridge runs on your Mac without a companion app or project-operated service.

[!IMPORTANT]
Open Things 3 before launching your LLM client.

Things must already be running on the Mac hosting Things MCP before you open your AI app or browser conversation. Otherwise, you may see “unable to connect to server”. Keep Things running while you use the connection.

Already seeing the error? Open Things, fully quit and reopen your desktop client (or reload your browser client), then start a new conversation and check the connection.

Install

Your client	Setup route
Claude Desktop on macOS	Download the `.mcpb` extension. No Terminal or separate runtime installation.
Cowork on a Mac	Use the same desktop extension, then check the connection in a new Cowork task.
ChatGPT in a browser	Set up a private tunnel. First-time setup requires developer commands.
Other MCP clients	Configure the local transport. Setup and compatibility depend on the host.

Claude Desktop

Download the .mcpb package from Releases.
Open Things 3 first, then launch Claude Desktop. If the client is already open and cannot connect, fully quit and reopen it after Things is running. Open the downloaded package and select Install. The desktop client supplies the runtime; no configuration editing or Terminal commands are needed.
Open Settings > Extensions > Things MCP > Configure. Enable Allow changes if you want to manage tasks, then select Save. New installations start read-only.
Start a new conversation and ask: Use Things MCP to check the connection without reading or changing tasks. Allow macOS Automation access to Things if prompted.
With Allow changes enabled, try: Use Things MCP to create an Inbox task called “Try Things MCP”, then read it back.

Cowork on a Mac

For Cowork on a Mac, use the same extension, start a new task, and select Cowork. Follow the Cowork installation and connection check for the steps, permission setting, and tested versions.

ChatGPT browser chats

Open Things 3 on your Mac before opening ChatGPT. Follow ChatGPT setup to connect a private tunnel on your Mac to your own account. First-time setup is currently an advanced installation.
Enable Allow changes from remote connections in the extension settings and select Save if you want to manage tasks through the tunnel.
Start a new conversation with the connection enabled and ask it to check the Things MCP connection. After setup, the background connection starts at login and does not need an open Terminal.

Other clients can use the standard local MCP transport. See other MCP clients. A model needs a client that supports tools; support for MCP alone does not guarantee compatibility with every host.

What works

Workflow	What you can do
Find and review	Search tasks, projects, areas and tags; query built-in lists and date filters.
Plan your day	Create tasks, edit notes, schedule dates, set deadlines, complete and reopen tasks.
Organize your work	Manage projects, areas and tags; move projects with task counts and descendant summaries.
Checklists and templates	Create checklists and project templates, duplicate items, set reminders and Evening through Things URLs.
Clean up deliberately	Move items to recoverable Trash with separate permission; restore open tasks and projects.

See the full operation list for version 1.0.2

Operation	Version 1.0.2
Search and read to-dos, projects, areas, and tags	Available
Create an Inbox to-do	Available
Edit a to-do's title and notes	Available
Set or clear a deadline	Available
Schedule a to-do on a calendar date	Available
Complete, cancel, or reopen a to-do	Available
Create and edit projects, areas, and tags	Available
Built-in list queries and project/area filters	Available
Moves between supported lists, projects, and areas	Available
Delete an individual task to Trash	Available with Trash permission
Create, replace, append or prepend checklist rows	Available through Things URLs
Create project templates with headings	Available through Things URLs
Move a task to an existing heading	Available through Things URLs
Duplicate a task or project	Available through Things URLs
Set Evening or a reminder time	Available through Things URLs
Restore open tasks and projects from Trash	Available
Delete projects, areas and tags	Available with container permission
Tag assignment, hierarchy and keyboard shortcuts	Available
Counts, selection, date filters and resumable searches	Available
Edit section headings inside a project	Not available
Create or change repeating schedules	Not available

Project moves return task counts and observed descendant changes in the same receipt. See project move results for the counts, changed-task details and read-back limits.

URL operations require one-time local setup for edits and duplication. Their receipts say “Sent to Things; result not verified” because Things does not expose complete read-back for those fields.

Native repeat-rule editing, full checklist/heading reads, arbitrary ordering and verified whole-library maintenance are unavailable. The capability reference explains field limits, search behavior, and unavailable features. Tools return their current implementation status through things_capabilities.

Try it in a conversation

Start with a connection check:

Use Things MCP to check the connection without reading or changing tasks.

Then try a read:

Show up to ten open Inbox tasks, without notes.

With Allow changes enabled:

Create one Inbox task called “Try Things MCP”, then read it back.

More everyday examples →

Requirements

A Mac with Things 3 installed and running before you launch your LLM client. Native checks used Things 3.23.3 and 3.23.4.
A client that supports the chosen connection. The packaged local route uses Claude Desktop; remote use depends on your ChatGPT account's available plugin and tunnel features.
macOS Automation permission to control Things when requested.
For remote access, the Mac must remain awake, online, and signed in.

Things and client subscriptions are separate products. This repository does not include Things, a subscription, or a vendor runtime license grant.

Your data and permissions

Task content requested in a conversation is shared with that client and its provider. The bridge does not collect Things Cloud credentials, write to the Things database, or provide a shell tool. No telemetry destination is bundled.

Writes require your local grant. Moving a task to Things’ recoverable Trash requires an additional permission so you can allow editing without allowing deletion. Every mutation checks permission and uses a durable request ID. Native task edits verify the exposed result in Things. URL tools report dispatch separately and do not claim a verified result. Edits also require the current item revision. Uncertain writes are never automatically repeated with a new request ID. These checks reduce duplicate and stale edits; Things automation is not transactional and cannot promise automatic rollback.

Local and remote connections share the same permission store, write lock, and request journal. See Security for the trust boundary and private vulnerability reporting.

Explore the project

Guide	What you will find
Installation	Step-by-step setup, permissions, updates and removal
Capabilities · Full scope	Available fields, read-back limits and unsupported operations
Privacy · Security	Data handling, trust boundaries and private vulnerability reporting
Verification · Changelog	Tested environments, remaining checks and release history
Contributing · Maintainer wiki	Development setup and architecture

Support and contribution

For a bug or feature request, open an issue with versions and a synthetic example. Keep task contents and credentials out of reports.
To contribute, follow Contributing. Developers can run the tests without Things, provider accounts, or personal configuration.
Financial support is optional and does not unlock features.

If Things MCP is useful to you, buy me a coffee.

Things MCP is an independent project. Product names identify compatibility; the project is not affiliated with or endorsed by the named vendors. Released under the MIT License. You may use, modify, and redistribute the code, including commercially, provided you retain its copyright and license notice. The software is provided without warranty. Third-party notices apply to their respective dependencies.

Things-MCP