Claude connector
Mad Lit has a built-in MCP (Model Context Protocol) server. Once connected, Claude can read your notes, create pages, search your workspace, and manage tasks — directly from the Claude app, without you switching context.
What Claude can do
| Capability | Example |
|---|---|
Read a page | "Summarise my meeting notes from last week" |
Create a page | "Create a page called Q3 Goals with these bullet points…" |
Search your workspace | "Find everything I've written about the redesign project" |
Append content | "Add these action items to my Sprint 4 page" |
List pages and sections | "What pages do I have in the Work section?" |
Create and manage tasks | "Add a task to review the contract by Friday" |
Read and reply to comments | "Check if I have any open comment threads" |
Two ways to connect
Choose based on how you use Claude. Most people should use the custom integration — it takes 30 seconds and requires no configuration files or API keys.
| Method | Works in | What you need |
|---|---|---|
Custom integration (recommended) | Claude.ai and Claude Desktop | Just your Google account |
Claude Code CLI | Claude Code terminal | An API key from Settings |
Option 1 — Custom integration (recommended)
This is the OAuth path. Claude redirects you to Mad Lit to approve access — no key to copy or store. Works in both Claude.ai on the web and in Claude Desktop.
- 1In Claude, open Settings → Integrations → Add custom integration.
- 2Give it a name (e.g. "Mad Lit") and paste the server URL:
https://madlit.io/api/mcp/http - 3Click Add. You'll be redirected to Mad Lit — sign in with your Google account and approve the consent screen.
- 4You're connected. Start a conversation and ask Claude about your notes.
Option 2 — Claude Code CLI
For the Claude Code command-line tool. You'll generate an API key in Mad Lit and register the server with one terminal command.
Step 1 — Generate an API key
- 1Open Mad Lit and go to Settings → Integrations.
- 2Under MCP API Key, click Generate key.
- 3Copy the key — it's shown once. If you lose it, delete it and generate a new one.
Step 2 — Register the server
Run this command in your terminal, replacing YOUR_KEY with the key from Step 1:
claude mcp add --transport http mad-lit https://madlit.io/api/mcp/http -H "x-api-key: YOUR_KEY"Mad Lit will be available in all future Claude Code sessions. To update the key later, re-run the same command with the new key (the remove step is handled automatically).
Tools reference
| Tool | What it does |
|---|---|
list_pages | List all pages and sections, with hierarchy |
search_pages | Full-text search across titles and content |
get_page | Read a page by ID — returns title and Markdown content |
create_page | Create a new page with optional content and location |
update_page | Replace a page's content or rename it |
append_to_page | Add Markdown to the end of a page without touching existing content |
create_section | Create a new sidebar section |
move_page | Move a page to a section or nest it under another page |
reorder_pages | Set the display order of pages within a section or parent page |
trash_page | Send a page to the trash |
create_task | Create a task (standalone or embedded on a page) |
list_tasks | List tasks with optional filters |
complete_task | Mark a task done |
get_discussions | Read open comment threads |
add_comment | Reply to a comment thread |
Privacy
The connector only sends content to Claude when you ask it to. OAuth sessions and API keys can both be revoked from Settings → Integrations at any time. API keys are stored as a one-way hash and cannot be read from the database.