Things3 MCP Server

by urbanogardun

201 downloads

Not rated

GitHub

Other

About

An MCP server that provides comprehensive integration with Things3 on macOS. It enables AI assistants and other MCP clients to interact with Things3 through 25 specialized tools, offering complete task management capabilities with intelligent error correction and automatic tag…

Details

Author: urbanogardun
Downloads: 201
Categories: Other

- 25 tools covering all aspects of Things3.
- TODO management: create, read, update, delete, complete, uncomplete.
- Project & area management with full lifecycle support.
- Hierarchical tag system with automatic tag creation.
- Bulk operations to move or update multiple items.
- Logbook search with date range filtering.
- Automatic error correction for common issues.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Things3 MCP Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "things3 mcp server": {
            "things3": {
                "command": "npx",
                "args": [
                    "things3-mcp@latest"
                ],
                "env": {
                    "THINGS3_AUTH_TOKEN": "your_auth_token_here"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "things3 mcp server": {
            "things3": {
                "command": "npx",
                "args": [
                    "things3-mcp@latest"
                ],
                "env": {
                    "THINGS3_AUTH_TOKEN": "your_auth_token_here"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "things3 mcp server": {
            "things3": {
                "command": "npx",
                "args": [
                    "things3-mcp@latest"
                ],
                "env": {
                    "THINGS3_AUTH_TOKEN": "your_auth_token_here"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "things3 mcp server": {
            "things3": {
                "command": "npx",
                "args": [
                    "things3-mcp@latest"
                ],
                "env": {
                    "THINGS3_AUTH_TOKEN": "your_auth_token_here"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "things3 mcp server": {
            "things3": {
                "command": "npx",
                "args": [
                    "things3-mcp@latest"
                ],
                "env": {
                    "THINGS3_AUTH_TOKEN": "your_auth_token_here"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "things3 mcp server": {
            "things3": {
                "command": "npx",
                "args": [
                    "things3-mcp@latest"
                ],
                "env": {
                    "THINGS3_AUTH_TOKEN": "your_auth_token_here"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "things3 mcp server": {
            "things3": {
                "command": "npx",
                "args": [
                    "things3-mcp@latest"
                ],
                "env": {
                    "THINGS3_AUTH_TOKEN": "your_auth_token_here"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "things3 mcp server": {
            "things3": {
                "command": "npx",
                "args": [
                    "things3-mcp@latest"
                ],
                "env": {
                    "THINGS3_AUTH_TOKEN": "your_auth_token_here"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "things3 mcp server": {
            "things3": {
                "command": "npx",
                "args": [
                    "things3-mcp@latest"
                ],
                "env": {
                    "THINGS3_AUTH_TOKEN": "your_auth_token_here"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "things3 mcp server": {
            "things3": {
                "command": "npx",
                "args": [
                    "things3-mcp@latest"
                ],
                "env": {
                    "THINGS3_AUTH_TOKEN": "your_auth_token_here"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "things3 mcp server": {
            "things3": {
                "command": "npx",
                "args": [
                    "things3-mcp@latest"
                ],
                "env": {
                    "THINGS3_AUTH_TOKEN": "your_auth_token_here"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "things3 mcp server": {
            "things3": {
                "command": "npx",
                "args": [
                    "things3-mcp@latest"
                ],
                "env": {
                    "THINGS3_AUTH_TOKEN": "your_auth_token_here"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "things3 mcp server": {
            "things3": {
                "command": "npx",
                "args": [
                    "things3-mcp@latest"
                ],
                "env": {
                    "THINGS3_AUTH_TOKEN": "your_auth_token_here"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "things3 mcp server": {
            "things3": {
                "command": "npx",
                "args": [
                    "things3-mcp@latest"
                ],
                "env": {
                    "THINGS3_AUTH_TOKEN": "your_auth_token_here"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "things3 mcp server": {
            "things3": {
                "command": "npx",
                "args": [
                    "things3-mcp@latest"
                ],
                "env": {
                    "THINGS3_AUTH_TOKEN": "your_auth_token_here"
                }
            }
        }
    }
}

From the repository

Install via npx (no installation required), global npm, or from source. Configure in your MCP client (e.g., Claude Desktop) by adding a things3 server entry with the command and a THINGS3_AUTH_TOKEN environment variable for update operations. The auth token is found in Things3 Settings > General > Enable Things URLs > Manage.

`todos_list`

List TODOs with optional filtering

`todos_get`

Get full details of a specific TODO

`todos_create`

Create a new TODO

`todos_update`

Update an existing TODO

`todos_complete`

Mark TODO(s) as complete

`todos_uncomplete`

Mark TODO(s) as incomplete

`todos_delete`

Delete TODO(s)

`projects_list`

List all projects in Things3

`projects_get`

Get detailed information about a specific project

`projects_create`

Create a new project in Things3

`projects_update`

Update an existing project

`projects_complete`

Mark a project as completed

`projects_delete`

Delete projects in Things3 (moves to trash)

`areas_list`

List all areas in Things3

`areas_create`

Create a new area in Things3

`areas_delete`

Delete areas in Things3 (moves to trash)

`tags_list`

List all tags in Things3 with hierarchy information

`tags_create`

Create a new tag in Things3

`tags_add`

Add tags to TODOs or projects

`tags_remove`

Remove tags from TODOs or projects

`tags_delete`

Delete tags completely from Things3

`bulk_move`

Move multiple TODOs to a project or area

`bulk_updateDates`

Update dates for multiple TODOs at once

`logbook_search`

Search completed items in the logbook with optional filters

`system_launch`

Launch Things3 application if not already running

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "things3 mcp server": {
            "things3": {
                "command": "npx",
                "args": [
                    "things3-mcp@latest"
                ],
                "env": {
                    "THINGS3_AUTH_TOKEN": "your_auth_token_here"
                }
            }
        }
    }
}

McpServers

{
    "things3": {
        "command": "npx",
        "args": [
            "things3-mcp@latest"
        ],
        "env": {
            "THINGS3_AUTH_TOKEN": "your_auth_token_here"
        }
    }
}

Things3 MCP Server

An MCP (Model Context Protocol) server that provides comprehensive integration with Things3 on macOS. This server enables AI assistants and other MCP clients to interact with Things3 through 25 specialized tools, offering complete task management capabilities with intelligent error correction and automatic tag creation.

Features

- Complete Things3 Integration: 25 tools covering all aspects of Things3
- TODO Management: Create, read, update, delete, complete, and uncomplete tasks
- Project & Area Management: Full project lifecycle support with area organization and deletion
- Tag System: Hierarchical tag support with creation, deletion, and bulk tag operations
- Bulk Operations: Efficiently move or update multiple items at once
- Automatic Tag Creation: Tags are automatically created when referenced in TODO/project operations
- Error Correction: Automatic fixing of common issues (date conflicts, missing titles)
- Logbook Search: Search completed items with date range filtering
- Performance Optimized: Connection pooling and AppleScript optimization

Requirements

- macOS (Things3 is macOS-only)
- Node.js >= 16.0.0
- Things3 app installed
- AppleScript access enabled in System Settings

Installation

Quick Start (Recommended)

You can use the server without any installation:

{
  "mcpServers": {
    "things3": {
      "command": "npx",
      "args": ["things3-mcp@latest"],
      "env": {
        "THINGS3_AUTH_TOKEN": "your_auth_token_here"
      }
    }
  }
}

Install from npm

npm install -g things3-mcp

Then add to your MCP client configuration:

{
  "mcpServers": {
    "things3": {
      "command": "things3-mcp",
      "env": {
        "THINGS3_AUTH_TOKEN": "your_auth_token_here"
      }
    }
  }
}

Install from Source

```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

todos_list

todos_get

todos_create

todos_update

todos_complete

todos_uncomplete

todos_delete

projects_list

projects_get

projects_create

projects_update

projects_complete

projects_delete

areas_list

areas_create

areas_delete

tags_list

tags_create

tags_add

tags_remove

tags_delete

bulk_move

bulk_updateDates

logbook_search

system_launch

Claude Desktop / Cursor

McpServers

Things3 MCP Server

Features

Requirements

Installation

Quick Start (Recommended)

Install from npm

Install from Source

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀

`todos_list`

`todos_get`

`todos_create`

`todos_update`

`todos_complete`

`todos_uncomplete`

`todos_delete`

`projects_list`

`projects_get`

`projects_create`

`projects_update`

`projects_complete`

`projects_delete`

`areas_list`

`areas_create`

`areas_delete`

`tags_list`

`tags_create`

`tags_add`

`tags_remove`

`tags_delete`

`bulk_move`

`bulk_updateDates`

`logbook_search`

`system_launch`