Things3

🚀 MCP Server for Things3

This MCP server provides integration with Things3, allowing you to create and manage tasks and projects via the MCP protocol. It specifically supports synchronization with Agenda projects.

🚀 Quick Start

This MCP server offers seamless integration with Things3, enabling users to effortlessly create and manage tasks and projects using the MCP protocol. It also provides dedicated support for synchronizing with Agenda projects.

✨ Features

• Create new projects in Things3.
• Create new to - do items with detailed attributes.
• Synchronize projects between Agenda and Things3.
• List current tasks and projects.
• Integrate with AppleScript for data retrieval.

📦 Installation

1. Ensure Python 3.8+ and Things3 are installed.
2. Clone this repository.
3. Install the dependencies:

pip install -e .

💻 Usage Examples

Basic Usage

The server provides several tools:

create - things3 - project

Create a new project in Things3, supporting the following options:

• Title (required)
• Notes
• Area
• Time
• Due date
• Tags
• Completion status
• Cancellation status

create - things3 - todo

Create a new to - do item in Things3, supporting the following options:

• Title (required)
• Notes
• Time
• Due date
• Review list
• Tags
• List
• Title
• Completion status
• Cancellation status
• Display status

sync - agenda - project

Create a Things3 project that mirrors an Agenda project, supporting the following options:

• Title (required)
• Notes
• Area

🔧 Technical Details

The server uses:

• x - callback - url to create projects in Things3.
• AppleScript to retrieve data from Things3.
• MCP protocol for communication.

📄 License

MIT