How do I connect Things MCP Server to Claude?

Run `claude mcp add hald-things-mcp -- uvx things-mcp` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.

Is Things MCP Server free?

The listed licence is MIT. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.

What can Things MCP Server do?

Things MCP Server documents 29 tools to the agent, including add-area, add-project, add-todo. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.

Things MCP

Unclaimed

by hald

Things.app MCP Server

Set up this server

Compare servers My Stack

01 / Choose your client

02 / Before you connect

Authentication is not specified. Check the project instructions before connecting.

Install the runtime required by the project and make it available to your client.

Project instructionsEnvironment variable names (optional)

Use names from the project instructions, separated by commas. Enter names only, never secret values.

03 / Add the configuration

Source: generated from public install instructions

claude mcp add --transport stdio 'hald-things-mcp' -- 'uvx' 'things-mcp'

Run in your terminal after replacing any placeholders.

04 / Check it in your client

Open your client’s MCP settings and confirm the server connects and lists its tools. A copied configuration does not confirm a working connection.

Is this your MCP server?

This listing was auto-indexed from the public record. Claim it to edit the page, set compatibility and unlock growth tools. Takes under two minutes.

Claim this server

Security profile

Claimed and verified servers get a weekly static scan that shows what the code can reach: external services, environment variables, shell commands, agent configuration folders, plus any dependencies with known advisories. Claim this listing to get one. How the security profile works

29 of 29 tools

Documented tools (29)

From project documentation. A server handshake does not verify each tool’s description or behavior.

add-area

Create a new Area (via AppleScript; Things URL scheme has no add-area command)

add-project

Create a new project

add-todo

Create a new todo

bulk-update-todos

Apply the same update to many todos in a single operation

get

projects / get-areas / get-tags

get-anytime

Get todos from Anytime list

get-areas

Get all areas

get-inbox

Get todos from Inbox

get-logbook

Get completed todos

get-projects

Get all projects

get-recent

Get recently created items

get-someday

Get todos from Someday list, including tasks in Someday projects

get-tag-usage

Report how many items use each tag, sorted by usage; flag unused tags for cleanup

get-tagged-items

Get items with a specific tag

get-tags

Get all tags

get-today

Get todos due today

get-todos

Get todos, optionally filtered by project

get-trash

Get trashed todos

get-upcoming

Get upcoming todos

limit

Maximum number of items to return (default: all; get-logbook defaults to 50)

offset

Number of items to skip from the start (default: 0)

search-advanced

Advanced search with multiple filters

search-items

Search for items in Things

search-todos

Simple search by title/notes

show-item

Show a specific item or list in Things

update

todo (checklist & tags)

update-area

Update an existing Area: rename or set tags (via AppleScript)

update-project

Update an existing project

update-todo

Update an existing todo

Tool change history

Compared across complete checks of the same configuration. Tools were listed, not invoked. Input-schema changes are not measured here.

No complete tool checks yet.

FAQ

Questions about Things MCP Server

How do I connect Things MCP Server to Claude?: Run `claude mcp add hald-things-mcp -- uvx things-mcp` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.
Is Things MCP Server free?: The listed licence is MIT. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.
What can Things MCP Server do?: Things MCP Server documents 29 tools to the agent, including add-area, add-project, add-todo. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.