Advertise
MCP.so
Sign In

Tinderbox MCP Server

@phkus

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

phkus

About Tinderbox MCP Server

An MCP server for interacting with the knowledge management tool Tinderbox.

Tinderbox MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "tinderbox-mcp": {
      "command": "python3",
      "args": [
        "-m",
        "venv",
        "venv"
      ]
    }
  }
}

Tinderbox MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Tinderbox MCP Server?

Tinderbox MCP Server is a Model Context Protocol server that lets AI assistants like Claude interact with Tinderbox, a macOS knowledge management application. It uses Tinderbox’s AppleScript integration to create and update notes and navigate document hierarchy.

How to use Tinderbox MCP Server?

Clone the repository, set up a Python virtual environment, install dependencies, and configure GitHub OAuth credentials via a .env file or environment variables. Start the server with python src/server.py, then add the connector URL (http://localhost:8000/mcp) in your MCP client (e.g., Claude Desktop or Mobile). For remote access, use Tailscale or Ngrok.

Key features of Tinderbox MCP Server

  • Create, link, and read notes in Tinderbox documents
  • Update note attributes, including name, text, position, and color
  • Retrieve hierarchical information: siblings, children, and outgoing links
  • HTTP transport for remote and mobile access
  • GitHub OAuth authentication for secure connections
  • AppleScript-based interaction – no breaking changes from version 0.1.x

Use cases of Tinderbox MCP Server

  • Create and organize notes in a Tinderbox document based on a conversation
  • Explore note hierarchies and let the assistant suggest connections
  • Reproduce diagrams from uploaded images using note position and color attributes
  • Connect Tinderbox to other services accessible by the AI assistant

Frequently asked questions

1

What are the dependencies and runtime requirements?

Tinderbox (macOS app), macOS, Python 3.10+, a GitHub account for OAuth, and an MCP‑compatible client. The server runs locally or can be exposed via Tailscale/Ngrok.

2

How does data stay secure with remote access?

The server uses GitHub OAuth authentication. Remote access via Tailscale (private network) or Ngrok (temporary public URL) is supported. Never disable authentication when exposing the server beyond localhost.

3

What are the limitations of update_attribute?

The `update_attribute` tool can overwrite any attribute, including Name and Text, potentially causing content loss. Keep backups. For extra safety, remove the tool or modify the AppleScript to restrict attribute editing.

4

Where do the AppleScript files live and can they be customized?

The `.scpt` files reside in the `applescripts/` directory (default path). They can be edited while the server runs, but adding custom tools requires restarting the server after modifying `src/server.py`.

5

How do I connect from Claude Mobile?

In the Claude app, go to Settings → Connectors and add a new connector with the URL `http://localhost:8000/mcp`. Complete GitHub OAuth in the browser to authenticate.

Comments

More Other MCP servers

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K
Advertise