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

by ragdollKB

5 stars

319 downloads

Not rated

GitHub

Developer Tools

About

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

Details

Author: ragdollKB
GitHub stars: 5
Downloads: 319
Categories: Developer Tools

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

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

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "tasknote bridge - swift mcp server with things 3 & apple notes \u2705": {
            "taskNote-bridge-mcp": {
                "command": "/Applications/TaskNote Bridge.app/Contents/Resources/launch_mcp_server.sh",
                "args": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tasknote bridge - swift mcp server with things 3 & apple notes \u2705": {
            "taskNote-bridge-mcp": {
                "command": "/Applications/TaskNote Bridge.app/Contents/Resources/launch_mcp_server.sh",
                "args": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tasknote bridge - swift mcp server with things 3 & apple notes \u2705": {
            "taskNote-bridge-mcp": {
                "command": "/Applications/TaskNote Bridge.app/Contents/Resources/launch_mcp_server.sh",
                "args": []
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "tasknote bridge - swift mcp server with things 3 & apple notes \u2705": {
            "taskNote-bridge-mcp": {
                "command": "/Applications/TaskNote Bridge.app/Contents/Resources/launch_mcp_server.sh",
                "args": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tasknote bridge - swift mcp server with things 3 & apple notes \u2705": {
            "taskNote-bridge-mcp": {
                "command": "/Applications/TaskNote Bridge.app/Contents/Resources/launch_mcp_server.sh",
                "args": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tasknote bridge - swift mcp server with things 3 & apple notes \u2705": {
            "taskNote-bridge-mcp": {
                "command": "/Applications/TaskNote Bridge.app/Contents/Resources/launch_mcp_server.sh",
                "args": []
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "tasknote bridge - swift mcp server with things 3 & apple notes \u2705": {
            "taskNote-bridge-mcp": {
                "command": "/Applications/TaskNote Bridge.app/Contents/Resources/launch_mcp_server.sh",
                "args": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tasknote bridge - swift mcp server with things 3 & apple notes \u2705": {
            "taskNote-bridge-mcp": {
                "command": "/Applications/TaskNote Bridge.app/Contents/Resources/launch_mcp_server.sh",
                "args": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tasknote bridge - swift mcp server with things 3 & apple notes \u2705": {
            "taskNote-bridge-mcp": {
                "command": "/Applications/TaskNote Bridge.app/Contents/Resources/launch_mcp_server.sh",
                "args": []
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "tasknote bridge - swift mcp server with things 3 & apple notes \u2705": {
            "taskNote-bridge-mcp": {
                "command": "/Applications/TaskNote Bridge.app/Contents/Resources/launch_mcp_server.sh",
                "args": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tasknote bridge - swift mcp server with things 3 & apple notes \u2705": {
            "taskNote-bridge-mcp": {
                "command": "/Applications/TaskNote Bridge.app/Contents/Resources/launch_mcp_server.sh",
                "args": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tasknote bridge - swift mcp server with things 3 & apple notes \u2705": {
            "taskNote-bridge-mcp": {
                "command": "/Applications/TaskNote Bridge.app/Contents/Resources/launch_mcp_server.sh",
                "args": []
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "tasknote bridge - swift mcp server with things 3 & apple notes \u2705": {
            "taskNote-bridge-mcp": {
                "command": "/Applications/TaskNote Bridge.app/Contents/Resources/launch_mcp_server.sh",
                "args": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tasknote bridge - swift mcp server with things 3 & apple notes \u2705": {
            "taskNote-bridge-mcp": {
                "command": "/Applications/TaskNote Bridge.app/Contents/Resources/launch_mcp_server.sh",
                "args": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tasknote bridge - swift mcp server with things 3 & apple notes \u2705": {
            "taskNote-bridge-mcp": {
                "command": "/Applications/TaskNote Bridge.app/Contents/Resources/launch_mcp_server.sh",
                "args": []
            }
        }
    }
}

From the repository

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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "tasknote bridge - swift mcp server with things 3 & apple notes \u2705": {
            "taskNote-bridge-mcp": {
                "command": "/Applications/TaskNote Bridge.app/Contents/Resources/launch_mcp_server.sh",
                "args": []
            }
        }
    }
}

McpServers

{
    "taskNote-bridge-mcp": {
        "command": "/Applications/TaskNote Bridge.app/Contents/Resources/launch_mcp_server.sh",
        "args": []
    }
}

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

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

Status: ✅ PRODUCTION READY - Complete MCP server with GUI monitoring

🚀 Quick Install

📥 Download & Install

1. Download the latest release 2. Open the DMG and drag TaskNote Bridge to Applications 3. Launch the app - the MCP server starts automatically 4. Configure VS Code with the settings below

⚙️ Claude Desktop Configuration

Add this to your Claude Desktop MCP server configuration:

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

> 📝 Note: Replace /path/to/tasknote-bridge/ with your actual installation directory. For example:
> - If you downloaded the release: /Users/[username]/Downloads/tasknote-bridge/
> - If you cloned the repo: /Users/[username]/Projects/tasknote-bridge/
> - If you moved it to Applications: /Applications/TaskNote Bridge/

⚙️ VS Code Configuration

Add this to your VS Code settings.json:

{
    "mcp": {
        "inputs": [],
        "servers": {
            "things-swift": {
                "command": "/path/to/tasknote-bridge/launch_swift_mcp_stdio.sh",
                "args": []
            }
        }
    }
}

That's it! 🎉 You're ready to create tasks and notes via AI assistants.

📋 Requirements

- macOS: 12.0+ (Monterey or later)
- Things 3: Install from Mac App Store
- Apple Notes: Built into macOS
- VS Code: With MCP extension

🎯 What Works Right Now

```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

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

🚀 Quick Install

📥 Download & Install

⚙️ Claude Desktop Configuration

⚙️ VS Code Configuration

📋 Requirements

🎯 What Works Right Now

Install

More like this

Sentry

Github

Git

GitLab

Context 7

Playwright