Used for local development and running the MCP server, with commands for installation, building, testing, and development workflows.
Allows saving GitHub repositories to Capacities spaces with custom metadata, tags, and descriptions through the save_weblink tool.
Provides specific configuration path information for setting up the MCP server on macOS systems with Claude Desktop.
Supports saving and formatting content as markdown in Capacities spaces, particularly for daily notes and weblink descriptions.
Capacities MCP Server
An MCP (Model Context Protocol) server for Capacities, providing seamless integration with your knowledge management system.
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
- Save Weblinks - Save URLs to your spaces with metadata
- Daily Notes - Add content to your daily notes
Installation
For Claude Desktop
Add the Capacities MCP server to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json
on macOS):
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_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
Saving Information
Daily Notes
Advanced Usage
License
MIT - see LICENSE file for details.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
Provides seamless integration with Capacities knowledge management system, allowing Claude to list spaces, retrieve space information, search content, save weblinks, and add content to daily notes.
Related MCP Servers
- -securityFlicense-qualityProvides memory/knowledge graph storage capabilities using Supabase, enabling multiple Claude instances to safely share and maintain a knowledge graph with features like entity storage, concurrent access safety, and full text search.Last updated -6JavaScript
- AsecurityAlicenseAqualityEnables querying and retrieving content from Confluence through CQL searches and page content fetching, allowing Claude to seamlessly access information stored in Confluence workspaces.Last updated -211JavaScriptMIT License
- -securityAlicense-qualityEnables Claude to interact with Webflow's APIs, allowing access to site information, collections, and other Webflow resources.Last updated -636TypeScriptMIT License
- -securityAlicense-qualityIntegrates with Claude to enable intelligent querying of documentation data, transforming crawled technical documentation into an actionable resource that LLMs can directly interact with.Last updated -1,776TypeScriptApache 2.0