things-mcp

This Model Context Protocol (MCP) server lets you use Claude Desktop to interact with your task management data in Things app. 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.

<a href="https://glama.ai/mcp/servers/t9cgixg2ah"></a>

• Access to all major Things lists (Inbox, Today, Upcoming, etc.)
• Project and area management
• Tag operations
• Advanced search capabilities
• Recent items tracking
• Detailed item information including checklists
• Support for nested data (projects within areas, todos within projects)

1. Prerequisites

• Python 3.12+
• Claude Desktop
• Things 3 ("Enable Things URLs" must be turned on in Settings -> General)

1. Install uv if you haven't already:

curl -LsSf https://astral.sh/uv/install.sh | sh

Resart your terminal afterwards.

1. Clone this repository:

git clone https://github.com/hald/things-mcp

1. Install the required Python packages:

cd things-mcp
uv venv
uv pip install -r pyproject.toml

1. Edit the Claude Desktop configuration file:

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

Add the Things server to the mcpServers key to the configuration file (be sure to update the path to the folder where you installed these files):

{
    "mcpServers": {
        "things": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/things-mcp",
                "run",
                "things_server.py"
            ]
        }