Happy slice of mcp pizzaMCP.pizza
Fire in da houseTop Tip:Paying $100+ per month for Perplexity, MidJourney, Runway, ChatGPT and other tools is crazy - get all your AI tools in one site starting at $15 per month with Galaxy AI Fire in da houseCheck it out free

mcp-things3

MCP.Pizza Chef: drjforrest

The mcp-things3 server integrates the Things3 macOS app with the Model Context Protocol, enabling creation, listing, and synchronization of todos and projects. It leverages AppleScript and x-call URLs to interact with Things3, supporting detailed task properties and synchronization with Agenda projects. This server facilitates automated task management workflows within Things3 through MCP.

Use This MCP server To

Create new projects in Things3 programmatically Add detailed todos with deadlines and tags in Things3 Synchronize projects between Agenda and Things3 List current tasks and projects from Things3 Automate task creation using AppleScript integration

README

MCP Server for Things3

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

mcp-things3 FAQ

How do I install the mcp-things3 server?
Ensure Python 3.8+ and Things3 are installed, clone the repo, then run 'pip install -e .'.
Can I create projects and todos with custom properties?
Yes, you can specify titles, notes, deadlines, tags, and more when creating projects or todos.
Does mcp-things3 support synchronization with other apps?
Yes, it supports synchronization of projects between Agenda and Things3.
What technologies does mcp-things3 use to interact with Things3?
It uses AppleScript and x-call URLs to read and write data in Things3.
Is this server compatible with multiple MCP clients?
Yes, it follows the MCP protocol and can work with any compliant MCP client.
Can I list all current tasks and projects from Things3?
Yes, the server provides tools to list existing tasks and projects.
What Python version is required to run this server?
Python 3.8 or higher is required.
Can this server handle task completion and cancellation statuses?
Yes, it supports marking tasks as completed or canceled when creating or updating todos.