mcp things3

Local 2025-09-01 00:47:10 0
Developer Tools @drjforrest/mcp-things3

Enables integration with Things3, allowing the creation and management of tasks and projects via the MCP protocol, including synchronization with Agenda projects.

This MCP server provides integration with Things3, allowing you to create and manage tasks and projects through the MCP protocol. It includes special support for synchronization with Agenda projects.

Features

  • Create new projects in Things3
  • Create new to-dos with detailed properties
  • Synchronize projects between Agenda and Things3
  • List current tasks and projects
  • AppleScript integration for data retrieval

Installation

  1. Ensure you have Python 3.8+ and Things3 installed
  2. Clone this repository
  3. Install dependencies: 
    pip install -e .

Usage

The server provides several tools:

create-things3-project

Creates a new project in Things3 with the following options: - title (required) - notes - area - when - deadline - tags - completed - canceled

create-things3-todo

Creates a new to-do in Things3 with the following options: - title (required) - notes - when - deadline - checklist - tags - list - heading - completed - canceled - reveal

sync-agenda-project

Creates a Things3 project that mirrors an Agenda project: - title (required) - notes - area

Development

The server uses: - x-callback-url for creating items in Things3 - AppleScript for retrieving data from Things3 - MCP protocol for communication

License

MIT