Metadata-Version: 2.4
Name: capturedit-mcp
Version: 0.2.0
Summary: CapturedIt MCP server for Claude Desktop, Cursor, and other MCP hosts (Python)
License-Expression: MIT
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: mcp>=1.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: respx>=0.21; extra == 'dev'
Description-Content-Type: text/markdown

# capturedit-mcp (Python)

Python MCP server for [CapturedIt](https://gotcaptured.com). 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

```bash
pip install capturedit-mcp
```

Or install from the monorepo:

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

## Usage

### Claude Desktop

Add to your `claude_desktop_config.json`:

```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`:

```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

```bash
pip install -e ".[dev]"
pytest
```
