TaskNote Bridge - Swift MCP Server with Things 3 & Apple Notes ✅
About
TaskNote Bridge - MCP Server for Things 3 and Apple Notes integration
Explore
- 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
From the repository
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)
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
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/
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.
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | nc localhost 8000
2. Check for available tools - you should see tools like:
- bb7_add-todo
- bb7_add-project
- bb7_get-today
- bb7_notes-create
- And many more...
3. Test task creation:
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "bb7_add-todo", "arguments": {"title": "Test from MCP!", "tags": ["test"]}}}' | /Applications/TaskNote\ Bridge.app/Contents/Resources/launch_mcp_server.sh
```
4. Verify in Things 3 - the test task should appear in your Inbox
Use TCP mode to connect multiple clients simultaneously
Keep TaskNote Bridge app open to monitor all MCP activity in real-time
- Check the app logs if you encounter any issues with tool calls
This server follows the standard MCP protocol and can work with any MCP-compatible application or AI assistant. Simply configure your tool to connect to the Swift MCP server using one of the methods above.
Compatible Applications Include:
- Claude Desktop
- VS Code with MCP extensions
- Cursor
- Continue
- Zed
- Sourcegraph Cody
- Any custom MCP client implementation
The server includes comprehensive error handling for:
- Invalid UUIDs and malformed requests
- Missing required parameters
- Things 3 database access errors
- Apple Notes AppleScript execution errors
- Data formatting and serialization errors
All errors are logged with descriptive messages. To review MCP logs:
```bash
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": []
}
}
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
<a href="https://glama.ai/mcp/servers/t9cgixg2ah"></a>
🚀 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 Codesettings.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
```bashSign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
