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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
capturedit_mcp-0.2.0.tar.gz
(5.0 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file capturedit_mcp-0.2.0.tar.gz.
File metadata
- Download URL: capturedit_mcp-0.2.0.tar.gz
- Upload date:
- Size: 5.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
853768a28cf777bd459bddd001c9179d6a5f2cd1e01f4368820ab417a1dfa957
|
|
| MD5 |
fad3195dd7aafe0b847be0ce19be16a1
|
|
| BLAKE2b-256 |
7118b15fa5809da8a14586a8ac2cc39448681c6c618d0da742e7dd9cc4021ebd
|
File details
Details for the file capturedit_mcp-0.2.0-py3-none-any.whl.
File metadata
- Download URL: capturedit_mcp-0.2.0-py3-none-any.whl
- Upload date:
- Size: 4.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a05a4db4bcc362bd21339ad6411178bfcd9173336652315970dc4a3676158121
|
|
| MD5 |
1d4a6d6abd1ed0d39b91f36ad8842317
|
|
| BLAKE2b-256 |
813e6a413aab1fe030ea69a157a59d7c60471063a01faa21aa18d6722c9ccdd7
|