things-mcp

MCP.Pizza Chef: hald

Everything in the Mac task manager becomes readable and writable in chat: Inbox, Today, Upcoming, projects, areas, and tags. You can add a to-do with its own checklist, change many tasks at once, hunt down items nobody has touched in weeks, or run a full weekly review by asking questions. It needs macOS, Things 3 with its URL setting switched on, and no paid key. Claude Desktop users install a downloadable bundle in one double-click; other apps take a short settings snippet.

Notes
Other

Use This MCP server To

See what's actually on my list for today Add a packing checklist for next week's trip Find tasks I haven't touched in over a month Sort my to-dos by what is genuinely urgent Run a weekly review across all my projects Clean up tags that nothing is using anymore

README

Things MCP Server

This Model Context Protocol (MCP) server lets you use Claude Desktop to interact with your task management data in Things 3 from Cultured Code. You can ask Claude to create tasks, analyze projects, help manage priorities, and more.

This server leverages the Things.py library and the Things URL Scheme.

Things Server MCP server

Support the Project

If you find this project helpful, consider supporting its development:

ko-fi

Features

  • Access to all major Things lists (Inbox, Today, Upcoming, etc.)
  • Project and area management
  • Tag operations
  • Advanced search capabilities
  • Recent items
  • Detailed item information including checklists
  • Support for nested data (projects within areas, todos within projects)
  • Someday project filtering: tasks in Someday projects are automatically excluded from Today, Upcoming, and Anytime views, matching Things UI behavior

Installation

Prerequisites

  • macOS (Things 3 is Mac-only)
  • Things 3 app with "Enable Things URLs" turned on (Settings → General)
  • A MCP client, such as Claude Desktop or Claude Code
  • uv Python package manager: brew install uv

Install via uvx (Any MCP Client)

things-mcp FAQ

Do I need a Mac?
Yes. Things 3 is a Mac-only app, so this works on macOS only.
Do I need a key or subscription?
No key. You do need Things 3 itself, with 'Enable Things URLs' switched on in its settings.
Which apps does it work in?
Claude Desktop and Claude Code are documented, and any other app that supports MCP servers can use it.
How hard is the setup?
Claude Desktop has a file you download and double-click. Other apps need a short snippet pasted into settings.
Can I use this to plan my week?
Yes — it can pull your projects and lists so you can run a full weekly review just by chatting.
Can it create tasks, or only read them?
Both. It adds and updates to-dos, projects, and areas as well as reading them.
Can it change lots of tasks at once?
Yes. A bulk update applies the same change to many to-dos in a single step.