MCP ExplorerExplorer

Mcp Things3

@drjforreston 9 months ago
18 MIT
FreeCommunity
AI Systems
A model context protocol for reading to-dos and writing to-dos and projects in the macOS application Things3, utilizing AppleScript and x-call URL.

Overview

What is Mcp Things3

mcp-things3 is a Model Context Protocol server designed for integrating with the macOS app Things3. It allows users to read and write todos and projects using a combination of AppleScript and x-call URLs.

Use cases

Use cases for mcp-things3 include automating task creation and management, synchronizing tasks between different applications, and enhancing productivity workflows through integration with AppleScript.

How to use

To use mcp-things3, ensure you have Python 3.8+ and Things3 installed. Clone the repository and install the dependencies using ‘pip install -e .’. You can then utilize commands like ‘create-things3-project’ and ‘create-things3-todo’ to manage your tasks and projects.

Key features

Key features include the ability to create new projects and todos in Things3, synchronize projects with Agenda, list current tasks and projects, and integrate with AppleScript for data retrieval.

Where to use

mcp-things3 can be used in personal productivity applications, project management, and task organization, particularly for users of the Things3 app on macOS.

Content

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

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers