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)
| File | Size | Uploaded | |
|---|---|---|---|
| capturedit_mcp-0.2.0.tar.gz | 5.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|