This MCP server provides comprehensive integration with Capacities knowledge management system, enabling AI assistants to read, search, and write content to your personal knowledge base.
Core Capabilities:
• List Spaces - Retrieve all your personal Capacities workspaces
• Space Information - Access detailed structures, collections, and metadata for specific spaces by ID
• Search Content - Perform full-text or title-only searches across spaces with optional filtering by space IDs and structure types
• Read Object Content - Retrieve complete note content by UUID, using direct API access with intelligent fallback to search aggregation, enhanced by an optional title parameter
• Save Weblinks - Bookmark URLs to spaces with optional metadata including custom titles, descriptions, markdown notes, and tags (up to 30 tags, with automatic creation if exact matches don't exist)
• Daily Notes - Append markdown content to today's daily note in any space, with options to specify origin or suppress timestamps
Key Features: All read operations are non-destructive (readOnly), supports UUID-based object identification, markdown formatting throughout, and rate-limited API access per Capacities specifications.
Capacities MCP Plus
An enhanced MCP (Model Context Protocol) server for Capacities, providing seamless integration with your knowledge management system.
Note: This is a fork of jemgold/capacities-mcp with additional features and fixes.
What's Different from the Original
Feature | Original | Plus |
Read Object Content | Not available | Retrieve full note content by object ID |
fastmcp Version | 1.27.3 | 3.25.4 (fixes MCP SDK compatibility) |
Windows Support | May have issues | Tested with cmd wrapper |
npm Package |
|
|
New Tool: capacities_read_object_content
Retrieve the full content of any Capacities object by its ID:
Tries undocumented API endpoints first for direct retrieval
Falls back to search API aggregation when direct access unavailable
Provides title parameter to improve search accuracy
Features
This MCP server provides access to all current Capacities API endpoints:
List Spaces - Get all your personal spaces
Space Information - Retrieve detailed space structures and collections
Search Content - Search across spaces with advanced filtering
Read Object Content - Retrieve full note content by object ID
Save Weblinks - Save URLs to your spaces with metadata
Daily Notes - Add content to your daily notes
Installation
For Claude Desktop (macOS)
Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):
For Claude Desktop (Windows)
Windows requires a cmd wrapper. Add to %APPDATA%\Claude\claude_desktop_config.json:
Get your Capacities API key from your Capacities account settings.
That's it! The server will be automatically downloaded and run when Claude Desktop starts.
Development
Local Setup
For local development, you'll need to clone and build the project:
Clone this repository:
Install dependencies:
Copy the example environment file:
Add your Capacities API key to
.env:
Build the server:
Running the Server
Start the development server with interactive mode:
For production use:
To inspect the server tools and schema:
Testing
Run the test suite:
Code Quality
Check linting and types:
Format code:
API Reference
Get your Capacities API key from your Capacities account settings.
For detailed API documentation, see:
Available Tools
capacities_list_spaces
Get a list of all your personal spaces.
capacities_get_space_info
Get detailed information about a specific space, including structures and collections.
spaceId: UUID of the space
capacities_search
Search for content across your spaces with optional filtering.
searchTerm: Text to search for
spaceIds: Array of space UUIDs to search in
mode (optional): "fullText" or "title" search mode
filterStructureIds (optional): Filter by specific structure types
capacities_read_object_content
Retrieve the full content of a Capacities object by its ID.
objectId: UUID of the object to retrieve (can be obtained from 'Copy object reference' in Capacities)
spaceId: UUID of the space containing the object
title (optional): The title or partial title of the object - strongly recommended to improve search results
How it works:
First attempts to use undocumented GET endpoints for direct object retrieval
Falls back to search API, aggregating content from highlights and snippets
Filters search results by object ID to find exact match
Note: When using search fallback, content may be incomplete as it's assembled from search snippets. Providing the title parameter significantly improves results.
capacities_save_weblink
Save a web link to a space with optional metadata.
spaceId: UUID of the target space
url: The URL to save
titleOverwrite (optional): Custom title for the link
descriptionOverwrite (optional): Description text
tags (optional): Array of tags. Tags need to exactly match your tag names in Capacities, otherwise they will be created.
mdText (optional): Text formatted as markdown that will be added to the notes section
capacities_save_to_daily_note
Add markdown content to today's daily note in a space.
spaceId: UUID of the target space
mdText: Markdown content to add
origin (optional): Origin label for the content (only "commandPalette" is supported)
noTimestamp (optional): If true, no timestamp will be added to the note
Rate Limits
The Capacities API has the following rate limits:
/spaces: 5 requests per 60 seconds/space-info: 5 requests per 60 seconds/search: 120 requests per 60 seconds/save-weblink: 10 requests per 60 seconds/save-to-daily-note: 5 requests per 60 seconds
Example Prompts
Here are some example prompts you can use with Claude when this MCP server is configured:
Getting Started
Exploring Your Knowledge Base
Searching Content
Reading Content
Saving Information
Daily Notes
Advanced Usage
Credits
License
MIT - see LICENSE file for details.