Things MCP

A Model Context Protocol (MCP) server for Things 3 integration. Enables Claude Desktop and Claude Code to interact with Things 3 on macOS.

- Create to-dos and projects with full metadata
- Update existing to-dos and projects
- List items from any Things list (Inbox, Today, Logbook, Trash, etc.)
- Retrieve all projects, areas, and tags
- Navigate to specific items or lists
- Search within Things
- Secure AppleScript execution
- Comprehensive error handling

- macOS with Things 3 installed
- Node.js 18 or later
- Things URL scheme enabled (automatic on first use)

This will automatically download, build, and start the MCP server.

git clone https://github.com/hildersantos/things-mcp.git cd things-mcp

-

Get your Things auth token(required for update operations):

- Open Things → Settings → General
- Enable Things URLs
- Click Manage → Copy Token

Open your Claude Desktop configuration file:

~/Library/Application Support/Claude/claude_desktop_config.json

Add the Things MCP server to themcpServerssection:

{ "mcpServers": { "things-mcp": { "command": "npx", "args": ["github:hildersantos/things-mcp"], "env": { "THINGS_AUTH_TOKEN": "your-token-here" } } } }

Replaceyour-token-herewith your actual Things auth token from step 1.

Restart Claude Desktopto apply the configuration changes.

If you prefer to install locally instead of using npx:

{ "mcpServers": { "things-mcp": { "command": "node", "args": ["/absolute/path/to/things-mcp/dist/index.js"], "env": { "THINGS_AUTH_TOKEN": "your-token-here" } } } }

Create a task "Buy milk" for today with tag "errands" in Things

Create a "Website Redesign" project in Things in my Work area

Plan a vacation to Japan in Things with research about destinations, booking flights and hotels, creating a packing list, and planning daily activities

Set up a new employee onboarding project in Things with IT setup tasks, HR paperwork, training schedule, and first week activities

Mark task ABC-123 as completed in Things

Add new tasks to my "Website Redesign" project in Things: create wireframes, design mockups, and user testing

Get full details for task TBeaUrcGH1zKoMmS7wwHVD from Things

Search for "meeting" in Things

Show me my completed tasks from the Things logbook

- things_add_todo- Create a to-do with all options
- things_add_project- Create a project with sections (headings), todos, and hierarchical organization

- things_update_todo- Update an existing to-do using JSON API for full feature support
- things_update_project- Update an existing project using JSON API for full feature support
- things_add_items_to_project- Add structured todos and headings to an existing project

- things_get_inbox- List inbox items
- things_get_today- List today's items
- things_get_upcoming- List scheduled items
- things_get_anytime- List anytime items
- things_get_someday- List someday items
- things_get_logbook- List completed items
- things_get_trash- List trashed items
- things_get_projects- List all active projects
- things_get_areas- List all areas
- things_get_tags- List all tags
- things_get_project- List items in a specific project (requires project_id)
- things_get_area- List items in a specific area (requires area_id)
- things_get_list- Get items from a specific list by name
- things_get_todo_details- Get detailed information about a specific to-do

All list tools support an optionalmax_resultsparameter to limit output.

# Development mode with watch npm run dev # Run linter npm run lint # Format code npm run format # Run tests npm test # Run tests in watch mode npm run test:watch

"Things 3 does not appear to be running"

Make sure Things 3 is installed and has been opened at least once.

Check that your THINGS_AUTH_TOKEN is correctly set in the MCP configuration.

On first run, macOS may ask for permission to control Things. Grant this permission for the MCP to work.

Use themax_resultsparameter when listing large collections:

Use things_get_projects with max_results 10

Built with theModel Context Protocol SDK. Things is a trademark of Cultured Code GmbH & Co. KG.

Remote MCP server for MindMeister. Create, edit, and organize mind maps from your AI assistant. Hosted (streamable-HTTP) — connect at https://mcp.mindmeister.com/mcp