Advertise
MCP.so
Sign In

Things3 MCP Server

@urbanogardun

Repository

Basic information

Category

Other

License

MIT license

Transports

stdio

Author

urbanogardun

About Things3 MCP Server

MCP server for Things3 integration on macOS

Things3 MCP Server config

Add this server to your MCP-compatible client using the configuration below.

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

Things3 MCP Server tools

25

List TODOs with optional filtering

Get full details of a specific TODO

Create a new TODO

Update an existing TODO

Mark TODO(s) as complete

Mark TODO(s) as incomplete

Delete TODO(s)

List all projects in Things3

Get detailed information about a specific project

Create a new project in Things3

Update an existing project

Mark a project as completed

Delete projects in Things3 (moves to trash)

List all areas in Things3

Create a new area in Things3

Delete areas in Things3 (moves to trash)

List all tags in Things3 with hierarchy information

Create a new tag in Things3

Add tags to TODOs or projects

Remove tags from TODOs or projects

Delete tags completely from Things3

Move multiple TODOs to a project or area

Update dates for multiple TODOs at once

Search completed items in the logbook with optional filters

Launch Things3 application if not already running

Overview

What is Things3 MCP Server?

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 creation.

How to use Things3 MCP Server?

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.

Key features of Things3 MCP Server

  • 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.

Use cases of Things3 MCP Server

  • A user asks Claude to create a project with tasks via natural language.
  • List today’s tasks and filter by search text.
  • Move multiple TODOs to a project or area in one operation.
  • Search completed items in the logbook by date range.
  • Automatically create tags when referenced during TODO or project creation.

Frequently asked questions

1

What are the system requirements?

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

2

How do I find my Things3 authorization token?

Open Things3, go to Settings > General, click "Enable Things URLs", then "Manage", and copy the authorization token value.

3

Does the server automatically create tags?

Yes, tags are automatically created when referenced in TODO or project operations if they do not already exist.

4

What error correction does the server perform?

It automatically fixes date conflicts (swaps when/deadline if deadline is before scheduled date), generates a title from notes if missing, moves items to Inbox if project/area doesn't exist, and cleans unsupported special characters in tag names.

5

What transports or authentication are required?

The server communicates locally via MCP with the Things3 app using AppleScript and Things3 URL scheme. Update operations require the THINGS3_AUTH_TOKEN environment variable.

Comments

More Other MCP servers

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

Soar Flight Booking MCP

Soar Flight Booking MCP is a remote MCP server available at https://mcp.soar.flights.

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K
Advertise