Context Hub API: connect your library to any AI

The Context Hub is CapturedIt’s API layer — a REST interface that lets any application search, read, and write to your personal library. It powers Custom GPT actions, Slack integrations, MCP servers, and your own scripts.

What the Context Hub provides

• Search: Full-text and semantic search across your library
• Read: Retrieve item metadata, content, and AI-generated summaries
• Write: Create new captures programmatically (Vault plan)
• Webhooks: Get notified when your library changes (Vault plan)

Authentication

API access uses scoped API keys generated in Dashboard → Security. Each key can be limited to specific permissions (read-only search, write access, etc.). Keys are tied to your account — private items remain excluded from API responses unless explicitly shared.

OpenAPI specification

The full API schema is available at https://api.capturedit.app/api/v1/openapi.json. This OpenAPI document is compatible with ChatGPT MCP apps, Claude connectors, and standard API clients. Import it into your tool of choice rather than writing endpoints from scratch.

Common integration patterns

ChatGPT (MCP app)

1. Vault → Connections → AI assistants → Connect ChatGPT
2. In ChatGPT: Plugins → Create MCP App → Server URL + OAuth
3. Paste the MCP connector URL and sign in with CapturedIt
4. Ask in a new chat about your library

Requires CapturedIt Vault. OpenAPI Actions remain a legacy option. See the full walkthrough in connecting bookmarks to ChatGPT and Claude.

Slack

CapturedIt includes a Slack integration with /capturedit commands to search, save, and ask questions about your library without leaving Slack. See the Slack setup guide for step-by-step instructions.

Webhooks

Vault includes signed webhooks for item.created and item.updated. See the webhooks setup guide for payload format and signature verification.

Gemini and Copilot

Import the same OpenAPI schema with API key auth in Google Gemini or Microsoft Copilot.

MCP (ChatGPT, Claude, Cursor)

For conversational AI tools that support Model Context Protocol, CapturedIt exposes an MCP server on Vault. This is the preferred integration for ChatGPT, Claude, and Cursor. See Cursor setup and our MCP guide.

SDKs and scripts

Official Python and Node SDKs wrap the REST API for common operations. Use them for automation: saving RSS feed items, syncing from other tools, or building custom dashboards.

Plan requirements

See pricing for current plan details and limits.

Security practices

• Create separate API keys for each integration — revoke individually if compromised
• Use read-only keys where write access is not needed
• Mark sensitive items as private — they are excluded from API and AI access
• Review connected apps periodically in Dashboard → Connections