Things3 MCP

Things3 MCP

Things3 task management integration for macOS with comprehensive TODO, project, and tag management.

13
Stars
1
Forks
2
Releases

Overview

The Things3 MCP Server provides a dedicated MCP server that integrates Things3 on macOS with a comprehensive toolkit of 25 MCP tools. It enables AI assistants and other MCP clients to manage TODOs, projects, areas, and tags with full CRUD and workflow capabilities. The server offers complete task management capabilities, including creating, reading, updating, deleting, completing, and uncompleting tasks, along with full project and area lifecycle support and hierarchical tag management. Features include automatic tag creation when referenced in TODO or project operations, bulk operations for moving or updating multiple items, and intelligent error correction to fix common issues such as date conflicts or missing titles. A logbook search supports date-range filtering for reviewing completed work. Performance optimizations include connection pooling and AppleScript enhancements. Configuration relies on Things3 authorization tokens for update operations. The project is modular, with dedicated tool modules for todos, projects, areas, tags, bulk, logbook, and system, plus AppleScript templates and utilities for date handling and error correction, designed for developers integrating Things3 workflows via MCP.

Details

Owner
urbanogardun
Language
TypeScript
License
MIT License
Updated
2025-12-07

Features

Complete Things3 Integration

25 tools covering all aspects of Things3 to expose full functionality through MCP.

TODO Management

Create, read, update, delete, complete, and uncomplete tasks with optional tags and notes.

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 such as date conflicts and missing titles.

Logbook Search

Search completed items with date range filtering.

Audience

AI assistantsInteract with Things3 via MCP tools for task, project, and tag management.
MCP clientsIntegrate Things3 functionality into automated workflows through MCP APIs.
macOS power usersProgrammatically manage tasks and projects on macOS with Things3.

Tags

Things3MCPmacOSTask ManagementProject ManagementTag ManagementAutomationAppleScriptURL SchemeIntegrationLogbookBulk Operations