capturedit-mcp 0.2.0

CapturedIt MCP server for Claude Desktop, Cursor, and other MCP hosts (Python)

capturedit-mcp (Python)

Python MCP server for CapturedIt. Connects Claude Desktop, Cursor, and other MCP hosts to your CapturedIt library — no Node.js required.

This is a direct port of the Node MCP server at packages/mcp-server.

Install

pip install capturedit-mcp

Or install from the monorepo:

cd packages/mcp-server-python
pip install -e .

Usage

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "capturedit": {
      "command": "capturedit-mcp",
      "env": {
        "CAPTUREDIT_API_URL": "https://api.capturedit.app",
        "CAPTUREDIT_API_KEY": "your_api_key"
      }
    }
  }
}

Cursor

Add to your .cursor/mcp.json:

{
  "mcpServers": {
    "capturedit": {
      "command": "capturedit-mcp",
      "env": {
        "CAPTUREDIT_API_URL": "https://api.capturedit.app",
        "CAPTUREDIT_API_KEY": "your_api_key"
      }
    }
  }
}

Tools

Tool	Description	Required scope
search_capturedit	Search your library (query, limit, offset)	search
get_context	Recent or relevant items for AI context (limit, offset, q, format, max_chars; Vault plan)	context:read
save_item	Save a new item (type, title, content_text, source_url, is_private)	items:write
ask_capturedit	Ask with AI using your library as context — available on all plans, subject to your ask quota	context:read

Environment variables

Variable	Default	Description
CAPTUREDIT_API_URL	https://api.capturedit.app	CapturedIt API base URL
CAPTUREDIT_API_KEY	(required)	Your CapturedIt API key

Development

pip install -e ".[dev]"
pytest