# jimfilippou/things-mcp [Health: Active]

**Category:** 🛠️ Other Tools and Integrations  
**Repository:** https://github.com/jimfilippou/things-mcp  
**GitHub Stars:** 10  
**npm Downloads (last month):** 45  
**Views:** 2  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/jimfilippou-things-mcp

## Description
A Model Context Protocol (MCP) server that provides seamless integration with the Things productivity app. This server enables AI assistants to create, update, and manage your todos and projects in Things using its comprehensive URL scheme.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "things-mcp": {
    "command": "npx",
    "args": ["-y","things-mcp"]
  }
}
```

## Documentation

## What jimfilippou/things-mcp MCP server does

The jimfilippou/things-mcp MCP server lets an MCP client operate Things 3 through Things URL commands. It focuses on todos and projects, with options for notes, scheduling, deadlines, tags, areas, headings, checklist items, completion state, and navigation.

The server supports both individual actions and structured operations. An assistant can create one todo or several todos, create a project with nested todos, change existing items, search Things data, or open a built-in list such as Today, Inbox, Anytime, or Someday. It can also return Things app and URL scheme version information.

## How it works

The server runs as an MCP process and sends requests to the Things application using its URL scheme. Things must be installed and running on macOS for the integration to work. Natural-language values such as “today,” “tomorrow,” “next week,” and specific dates can be passed to scheduling and deadline fields.

The main operations are `add-todo`, `add-project`, `update`, `update-project`, `show`, `search`, `json`, and `version`. The `json` operation accepts structured data for more complex batches, including projects with headings and nested todos. The server validates parameters with Zod and reports URL, authorization, network, and system errors.

Updates need an item identifier and an authorization token from Things. Item IDs can be copied from Things share links on macOS or iOS. The token is obtained from Things settings after enabling Things URLs.

## Setup and configuration

The jimfilippou/things-mcp MCP server requires macOS, Things 3, Node.js 16 or later, and an MCP-compatible client. Things URLs must be enabled in the app settings. The package can be run without a separate installation with:

```bash
npx things-mcp
```

It can also be installed globally with `npm install -g things-mcp`, then started with `things-mcp`.

For Claude Desktop, add a `things` entry to `claude_desktop_config.json`. The command can use `npx` with the `-y` flag, or the globally installed executable. After changing the configuration, restart Claude Desktop or the relevant MCP client and inspect its logs if the connection does not start.

## Tools and capabilities

- Create one or multiple todos with titles, notes, dates, tags, checklists, project placement, headings, and status fields.
- Create projects with notes, scheduling, deadlines, tags, area placement, and an initial set of todos.
- Update todos and projects, including notes, dates, tags, locations, checklists, completion, cancellation, and duplication.
- Search Things data and show items, lists, or tag-filtered results.
- Submit JSON structures for batch creation of projects, headings, and nested todos.
- Reveal newly created items or navigate to selected Things locations.

## Limitations and notes

This integration is macOS-specific because it depends on the Things application. It is not suitable for an environment without Things 3 installed and running. Update operations require a valid Things authorization token, while item-specific changes also require the corresponding Things ID.

The server works through Things URLs rather than a separately described remote Things API, so Things URL settings must be enabled. If Things does not open, verify the app installation and version, confirm URL support is enabled, and check the MCP client configuration.

_Full upstream README: https://allmcps.com/mcp/jimfilippou-things-mcp/readme_