TaskNote Bridge MCP Server

TaskNote Bridge - MCP Server for Things 3 and Apple Notes integration

Local serverstdioGo

What is the TaskNote Bridge MCP server?

TaskNote Bridge - MCP Server for Things 3 and Apple Notes integration. Exposed over MCP by the tasknote bridge mcp server, that capability becomes something an assistant can invoke while it works, not something you go and do afterwards.

What it actually does

A native macOS Swift application that implements a complete Model Context Protocol (MCP) server for Things 3 and Apple Notes integration.

Its toolset

Everything the assistant can do here goes through one of these:

  • Configuration — The Configuration tool exposed by this server
  • Prerequisites — The Prerequisites tool exposed by this server
  • Usage — The Usage tool exposed by this server

Configuration

  • Any MCP-compatible AI assistant or tool (Claude Desktop, VS Code with MCP extensions, Cursor, Continue, Zed, etc.) * Things 3 ("Enable Things URLs" must be turned on in Settings -> General) * Apple Notes (for note management features) * macOS 13.0 or newer (required for SwiftUI and AppleScript integration)

Adding it to your client

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client. The configuration blocks on this page cover the common clients.

When to reach for it

This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. TaskNote Bridge's toolset — Configuration, Prerequisites, Usage — is a fair guide to whether it matches your workflow. It is maintained by ragdollKB; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the tasknote bridge mcp server does with a few real requests.

Available tools

ToolWhat it does
ConfigurationThe Configuration tool exposed by this server.
PrerequisitesThe Prerequisites tool exposed by this server.
UsageThe Usage tool exposed by this server.

How to install the TaskNote Bridge MCP server

{
    "mcpServers": {
        "tasknote-bridge": {
            "command": "/path/to/tasknote-bridge/launch_swift_mcp_stdio.sh"
        }
    }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Any MCP-compatible AI assistant or tool (Claude Desktop, VS Code with MCP extensions, Cursor, Continue, Zed, etc.) * Things 3 ("Enable Things URLs" must be turned on in Settings -> General) * Apple Notes (for note management features) * macOS 13.0 or newer (required for SwiftUI and AppleScript integration)

Example prompts to try

  • Use TaskNote Bridge to Configuration.
  • Use TaskNote Bridge to Prerequisites.
  • Use TaskNote Bridge to Usage.

Frequently asked questions

macOS 12.0 or later (Monterey+), with Things 3 installed from the Mac App Store and Apple Notes built into the system.