things-mcp

Things.app MCP Server

GitHub Stars

124

User Rating

Not Rated

Favorites

0

Views

19

Forks

18

Issues

2

Installation
Difficulty
Beginner
Estimated Time
5-10 minutes

Installation

Installation

Prerequisites

Please specify required software and versions:
Python: 3.12 or higher
Claude Desktop: Latest version
Things 3: Must have "Enable Things URLs" turned on in Settings -> General.

Installation Steps

1. Install uv if you haven't already:

bash
curl -LsSf https://astral.sh/uv/install.sh | sh
Restart your terminal afterwards.

2. Clone this repository:

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

3. Install the required Python packages:

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

4. Edit the Claude Desktop configuration file:

bash
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):
json
{
    "mcpServers": {
        "things": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/things-mcp",
                "run",
                "things_server.py"
            ]
        }
    }
}

5. Restart the Claude Desktop app.

Additional Resources