Unofficial Capacities.io MCP Tools

Disclaimer

This project provides several methods for connecting to the Capacities note taking app API using the Model Context Protocol (MCP). It was 100% vibe-coded with the help of Gemini 2.5 Pro. While it works, it relies on third-party adapter services and, in some cases, your own hosting. Use at your own risk.

For everyone looking for a native Bun implementation, there exists another project https://github.com/jem-computer/capacities-mcp

---

Table of Contents

1. Setup for Claude Desktop (with Node.js Bridge)
   • Use this if you need to connect Claude Desktop and it requires simple tool names.
2. Setup for Simple SSE Clients (CLion, VS Code)
   • Use this for a direct connection from a compatible IDE plugin.
3. Advanced Setup for Genspark (Self-Hosted Server)
   • The most reliable and robust method. Use this for Genspark or any other client if you have your own server/VPS.

---

General Prerequisites

• A Capacities API Token. You can generate this from your Capacities account settings if you have a paid account.
• The MCP Link Generator tool: https://mcp-link.vercel.app/

---

Setup 1: Claude Desktop (with Node.js Bridge)

This method uses the included capacities-claude-bridge.js script to act as a translator between Claude Desktop (which needs simple tool names) and the MCP adapter (which creates complex names).

Step 1.1: Install Node.js and Download Files

1. Install Node.js: Go to the official Node.js website and download and install the LTS version for your operating system.

2. Download the Bridge Code: Open a terminal (like Git Bash, Command Prompt, or PowerShell) and run the following commands:

   # Clone the repository to a permanent location
   git clone https://github.com/natkitten/capacities-mcp-bridge-unofficial.git
   
   # Navigate into the project folder
   cd capacities-mcp-bridge-unofficial
   

3. Install Dependencies: While inside the capacities-mcp-bridge-unofficial folder, run:

   npm install
   

Step 1.2: Generate the Server URL for the Bridge

1. Go to mcp-link.vercel.app.
2. Fill in the form:
   • OpenAPI Specification URL: Use this specific URL for the Claude bridge setup. It uses snake_case operationIds.

     https://gist.githubusercontent.com/natkitten/e6ce1335c2cdad87a9237156c5cda315/raw/capacities_openapi_2.json
     

   • API Base URL: https://api.capacities.io
   • HTTP Headers: Enter your Authorization header:

     Authorization: Bearer YOUR_CAPACITIES_API_TOKEN
     

   • Path Filters: Leave this field completely empty.
   • Encoding Options: Select "Base64 (JSON Encoded)".
3. Click "Generate MCP Link" and copy the resulting URL.

Step 1.3: Configure the Bridge Script