Things MCP Server

Things 3 task management via natural language queries and project planning.

Data last scanned today · Reviewed today

4525 tools★ 538PythonMIT

Overview

This MCP server enables integration with the Things 3 task manager on macOS, allowing AI assistants to read lists, analyze project structures, and manage priorities. By leveraging the Things URL scheme, users can interact with their productivity data directly through clients like Claude Desktop. Capabilities include retrieving tasks from Inbox, Today, and Upcoming lists, as well as executing operations like task creation with checklists. It also respects the internal logic of the Things application, such as filtering Someday projects to maintain consistency with the desktop user interface.

Our verdict

This server carries a high risk level with a security score of 45/100, primarily because the authentication method and read-only mode have not yet been editorially reviewed. As a community-maintained project that is not managed by the official vendor, it requires caution. Users who prioritize strict security oversight or official support should exercise care, as the underlying mechanisms for interacting with the Things URL scheme have not undergone independent security verification.

Supports nested project and area data structures
Matches Things UI behavior by filtering Someday projects
Requires zero direct dependencies for operation
MIT licensed open-source repository

Authentication method security is not yet reviewed
Read-only capabilities lack editorial verification
Not maintained by the official Cultured Code vendor

Tools

Tool	Description	Risk
get-inbox	Get todos from Inbox	low
get-today	Get todos due today	low
get-upcoming	Get upcoming todos	low
get-anytime	Get todos from Anytime list	low
get-someday	Get todos from Someday list, including tasks in Someday projects	low
get-logbook	Get completed todos	low
get-trash	Get trashed todos	low
get-todos	Get todos, optionally filtered by project	low
get-projects	Get all projects	low
get-areas	Get all areas	low

Compatibility

Client	Local	Docker	Remote	Read-only
ChatGPT
Claude Desktop
Cursor
VS Code
Windsurf

Frequently asked questions

›What are the system requirements for using this MCP server?

This server requires macOS, the Things 3 application, and the uv Python package manager. Additionally, you must enable 'Things URLs' in the Things 3 settings under General.

›Are there any manual configuration steps for Claude Desktop?

You can perform a one-click install using the .mcpb release file or manually edit your Claude configuration file to add the 'things' server with the 'uvx' command.

›How are Someday projects handled by this server?

Tasks within Someday projects are automatically excluded from the Today, Upcoming, and Anytime views, which ensures the server's output matches the standard Things UI behavior.

›Can I limit the number of items returned when querying my lists?

Yes, most read tools support pagination via the optional 'limit' and 'offset' parameters. If these are not provided, the server defaults to returning all items, except for the logbook, which defaults to 50.

›Does the server support creating or updating Areas?

Yes, the server supports adding and updating areas using AppleScript, as the native Things URL scheme does not currently provide commands for these specific actions.