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" |
Set up the connector
Step 1 — Get your API key
- 1Open Mad Lit and go to Settings (bottom of the sidebar).
- 2Click Integrations.
- 3Under MCP API Key, click Generate key.
- 4Copy the key — it's shown once and can't be retrieved again. If you lose it, generate a new one.
Step 2 — Add Mad Lit as a custom connector in Claude
- 1Open Claude.ai and go to Settings → Integrations.
- 2Click Add custom connector.
- 3Enter the following details:
Field Value NameMad Lit MCP server URLhttps://madlit.io/api/mcp/http AuthenticationAPI key API key headerx-api-key API key valueyour key from Step 1 - 4Save. The connector will appear in the integrations list as active.
Step 3 — Use it
Start a new conversation in Claude and mention your notes. Claude will automatically call the Mad Lit tools when it needs to read or write content. You can also be explicit: "Using my Mad Lit notes, summarise what I know about project X."
Connector 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 |
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. Your API key is stored as a one-way hash — it can't be read from the database. You can revoke access at any time by deleting the key in Settings and removing the connector from Claude.
Tip: Questions? Email info@madlit.io.