Things3 MCP Server
@urbanogardun
About Things3 MCP Server
MCP server for Things3 integration on macOS
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"
}
}
}
}Tools
25List 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.
FAQ from Things3 MCP Server
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.
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.
Does the server automatically create tags?
Yes, tags are automatically created when referenced in TODO or project operations if they do not already exist.
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.
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.
Frequently asked questions
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.
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.
Does the server automatically create tags?
Yes, tags are automatically created when referenced in TODO or project operations if they do not already exist.
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.
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.
Basic information
More Other MCP servers
π Model Context Protocol (MCP) Curriculum for Beginners
microsoftThis open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,
IDA Pro MCP
mrexodiaAI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP.
MCP Registry
modelcontextprotocolA community driven registry service for Model Context Protocol (MCP) servers.
MaxKB
1Panel-devπ₯ MaxKB is an open-source platform for building enterprise-grade agents. 强倧ζη¨ηεΌζΊδΌδΈηΊ§ζΊθ½δ½εΉ³ε°γ
Glasswarp
GlasswarpSee and control a real Windows PC you own β from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.
Comments