Skip to main content

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

Metadata

Release files for capturedit-mcp 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for capturedit-mcp 0.2.0
File Size Uploaded
capturedit_mcp-0.2.0.tar.gz 5.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for capturedit-mcp 0.2.0
File Interpreter ABI Platform
capturedit_mcp-0.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 9.3 kB

Release files / capturedit_mcp-0.2.0.tar.gz

Download URL capturedit_mcp-0.2.0.tar.gz
Size 5.0 kB
Tags Source
SHA-256 checksum
How to use checksums
853768a28cf777bd459bddd001c9179d6a5f2cd1e01f4368820ab417a1dfa957
BLAKE2b-256 checksum
How to use checksums
7118b15fa5809da8a14586a8ac2cc39448681c6c618d0da742e7dd9cc4021ebd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.12

Release files / capturedit_mcp-0.2.0-py3-none-any.whl

Download URL capturedit_mcp-0.2.0-py3-none-any.whl
Size 4.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a05a4db4bcc362bd21339ad6411178bfcd9173336652315970dc4a3676158121
BLAKE2b-256 checksum
How to use checksums
813e6a413aab1fe030ea69a157a59d7c60471063a01faa21aa18d6722c9ccdd7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.12

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page