TaskNote Bridge

Provides a native MCP server to access Things 3 and Apple Notes via MCP clients and AI assistants.

other

3

GitHub Stars

other

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "ragdollkb-tasknote-bridge-mcp": {
      "command": "/path/to/TaskNote Bridge.app/Contents/Resources/launch_swift_mcp_stdio.sh",
      "args": []
    }
  }
}

You run a native macOS MCP server that lets you manage Things 3 tasks and Apple Notes from AI assistants and MCP clients. It provides a complete Swift MCP server with a GUI monitoring app and a lightweight stdio-based server for reliable integration with Claude Desktop and other MCP clients.

How to use

You connect your MCP client to the TaskNote Bridge server to perform operations on Things 3 and Apple Notes. Use the stdio-based server for Claude Desktop and most MCP clients, or run the GUI app for real-time monitoring and TCP access. Once connected, you can create and manage tasks in Things 3, create and search Apple Notes, and open items directly in their native apps. The server exposes a variety of tools you can call from your assistant to list, query, and manipulate data.

How to install

Option 1: Download and run the app
- Download the latest TaskNote Bridge app
- Open the DMG and drag TaskNote Bridge to Applications
- Launch the app from Applications
- The MCP server starts automatically
- Open your MCP client and configure it to connect to the stdio server

Option 2: Build from source
- Install Xcode 14.0 or newer
- macOS 13.0 or newer
- Clone the repository
- Open in Xcode and build
- Run the TaskNote Bridge app

Additional content

Prerequisites: macOS 13.0 or newer, Things 3 with Things URLs enabled, Apple Notes, and a compatible MCP client or AI assistant.

Configuration guides below show how to connect Claude Desktop and VS Code to the stdio-based MCP server. The stdio server runs via a launcher script embedded in the app bundle. Use the full paths shown in the examples to point your MCP client at the correct launcher script.

Troubleshooting and verification

If you need to verify that the stdio server is responding, run a simple call through the launcher script and check the response. If the GUI app is running, you can view real-time activity and logs from the built-in monitoring interface.

For Claude Desktop connection issues, ensure you are using the stdio launcher path and that the command points to the launcher script in the app bundle. If you encounter timeouts, restart Claude Desktop and re-test the stdio flow.

Usage within clients

Claude Desktop, VS Code with MCP extension, Cursor, Continue, Zed, and other MCP-capable tools can connect to the stdio server. Use the provided config snippets to point the client at the launcher script and keep the args array empty if no extra arguments are needed.

Notes

The server also includes a GUI application for monitoring the server status, active connections, and live logs, alongside a lightweight stdio-based server ideal for reliable MCP communication with AI assistants.

Available tools

tools/list

List available MCP tools and endpoints exposed by the server so you can discover what you can call from an MCP client.

tools/call

Invoke a specific tool by name with arguments to perform actions in Things 3 or Apple Notes.

tools/get-todos

Retrieve to-dos from Things 3, with optional filtering by project or area.

tools/get-projects

List all projects in Things 3 to organize tasks.

tools/get-areas

List all areas in Things 3 to help categorize work.

tools/get-inbox

Fetch items from the Things Inbox.

tools/get-today

Fetch items due today in Things 3.

tools/get-upcoming

Fetch upcoming items in Things 3.

tools/get-logbook

Fetch completed items from Things 3.

tools/get-trash

Fetch trashed items from Things 3.

tools/get-tags

List all tags used in Things 3.

tools/get-tagged-items

Get items that have a specific tag.

tools/search-todos

Perform a simple search for to-dos by title or notes.

tools/search-advanced

Perform an advanced search with multiple filters across Things 3 data.

tools/open-todo

Open a specific to-do in the Things 3 app by title.

notes-create

Create new Apple Notes with titles, content, and tags.

notes-search

Search Apple Notes by title or content.

notes-retrieve

Retrieve the content of an Apple Note.

notes-list

List all notes in Apple Notes.

notes-open

Open a specific Apple Note in Apple Notes.

notes-delete

Delete a note from Apple Notes.

notes_applescript

Use AppleScript integration to control Apple Notes from MCP.