Things

MCP server for Things 3 that enables creation, update, deletion, navigation, search, and JSON import of tasks and projects via URL schemes.

javascript

0

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mieluoxxx-things_mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@moguw/things_mcp"
      ],
      "env": {
        "THINGS_AUTH_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

This MCP server lets Things 3 users manage tasks and projects via URL schemes. It supports creating, updating, deleting items, navigating and searching, and JSON bulk imports, making it easy to control Things 3 programmatically from client apps or automation workflows.

How to use

You can interact with the Things MCP server from your MCP client to perform common task management actions. Use the available endpoints to create, update, delete, or search for todos and projects, or import data in JSON format. Securely provide your authorization token so the server can access Things 3 on your Mac.

How to install

Prerequisites you need before starting:

macOS is required because the MCP server relies on macOS-specific open workflows
Node.js 18 or newer
Things 3 for Mac app

Obtain an authorization token from Things. Open Things → Settings → General → Enable Things URLs → Manage, then copy the token.
Configure the MCP server in Claude Code using the command below. This registers the Things MCP server and passes your token as an environment variable.

export THINGS_AUTH_TOKEN="YOUR_TOKEN"

claude mcp add things --command "npx" --args "-y" "@moguw/things_mcp" --env "THINGS_AUTH_TOKEN=$THINGS_AUTH_TOKEN"

Alternatively, you can manually edit the macOS configuration file to define the MCP server. Use the exact snippet below in your editor at the specified path.

{
  "mcpServers": {
    "things": {
      "command": "npx",
      "args": ["-y", "@moguw/things_mcp"],
      "env": {
        "THINGS_AUTH_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

After adding or modifying the MCP server, restart Claude Code if prompted to ensure the new server is loaded.

Notes and tips

The Things MCP server exposes a set of operations you can call from any MCP client that supports the protocol. Tokens are required for actions that modify data.
The server runs locally on macOS; ensure Things 3 for Mac is installed and running when you perform actions.

Available tools

add_todo

Create a new todo item in Things 3 with optional fields such as title, notes, due date, and project association.

add_project

Create a new project in Things 3 and optionally attach todos or set metadata.

update_todo

Update properties of an existing todo, such as title, notes, due date, or flags.

update_project

Update properties of an existing project, including name and attributes.

delete_todo

Remove a specific todo by its ID from Things 3.

delete_project

Remove a specific project by its ID from Things 3.

show

Navigate to a specific list or project within Things 3.

search

Search for tasks or projects within Things 3 by keywords or attributes.

json_import

Import multiple items from a JSON payload into Things 3 in bulk.

get_version

Retrieve the version information of the MCP server integration or the Things connector.