Tinderbox MCP Server logo

Tinderbox MCP Server

by phkus

The Tinderbox MCP Server enables AI assistants like Claude to interact with Tinderbox, a knowledge management application for macOS. It allows controlling Tinderbox with natural language and connecting it to other services the assistant has access to.

View on GitHub

Last updated: N/A

What is Tinderbox MCP Server?

A Model Context Protocol (MCP) server that allows AI assistants like Claude to control and interact with Tinderbox, a macOS application for knowledge management, using natural language.

How to use Tinderbox MCP Server?

  1. Clone the repository, 2. Install dependencies using npm install, 3. Build the project with npm run build, 4. Run the server using npm run start, 5. Configure Claude Desktop with the server details in claude_desktop_config.json, 6. Restart Claude and ask it to work with your Tinderbox documents.

Key features of Tinderbox MCP Server

  • Create new notes

  • Create links between notes

  • Update note attributes

  • Retrieve note content

  • Find sibling notes

  • Get child notes

  • Find outgoing links

Use cases of Tinderbox MCP Server

  • Creating notes based on conversation with an AI assistant.

  • Exploring the hierarchy of a Tinderbox document using natural language commands.

  • Creating diagrams in Tinderbox based on uploaded images.

  • Automating Tinderbox tasks through AI assistance.

FAQ from Tinderbox MCP Server

What is MCP?

Model Context Protocol, a protocol for AI assistants to interact with applications.

What is Tinderbox?

A powerful knowledge management application for macOS.

What is the default Tinderbox document?

The default document is 'Playground', but this can be configured.

Can I extend the server with custom Tinderbox operations?

Yes, by creating new AppleScript files, adding configurations in src/index.ts, and rebuilding the project.

What are the prerequisites for running the server?

Tinderbox, Node.js 18 or higher, and an MCP-compatible client (tested with Claude Desktop).