TaskNote Bridge - Swift MCP Server with Things 3 & Apple Notes ✅

What is TaskNote Bridge?

TaskNote Bridge is a native macOS Swift application that implements a complete Model Context Protocol (MCP) server for integrating Things 3 and Apple Notes with AI assistants. It is designed for macOS users who want to create tasks and notes via AI tools like Claude Desktop and VS Code.

How to use TaskNote Bridge?

Download the DMG from releases, open it, and drag TaskNote Bridge to Applications. Launch the app to start the MCP server automatically. Then configure your MCP client (e.g., Claude Desktop, VS Code) by pointing to the launch_swift_mcp_stdio.sh script or launch_mcp_server.sh script. Verify connection by testing a tool call like bb7_add-todo.

Key features of TaskNote Bridge

• Complete MCP server for Things 3 and Apple Notes integration
• Real-time monitoring dashboard with live activity tracking
• TCP transport for network-based connections
• Stdio transport for lightweight command-line usage
• Modern SwiftUI interface for server control
• Full AppleScript integration for seamless macOS experience

Use cases of TaskNote Bridge

• Create Things 3 tasks, projects, and tags via AI assistants
• Search and manage Apple Notes through MCP-compatible clients
• Monitor server activity in real time with a graphical dashboard
• Integrate with Claude Desktop, VS Code, Cursor, Continue, Zed, and custom clients
• Test and verify MCP tool calls using stdio or TCP endpoints

FAQ from TaskNote Bridge

What runtime environment is required?

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

How does the server communicate with clients?

Two transport options: stdio (recommended for most clients like Claude Desktop) and TCP (port 8000, configurable, for custom clients).

Which MCP clients are supported?

Any MCP-compatible tool: Claude Desktop, VS Code with MCP Extension, Cursor IDE, Continue, Zed Editor, and custom TCP/stdio clients.

Where are logs stored?

Claude Desktop logs are at ~/Library/Logs/Claude/mcp*.log. The GUI app provides live logs with filtering and search.

What authentication methods are supported?

None mentioned. The server runs locally and does not require authentication.