---
title: "Add SuperEbook to Claude Code"
description: "Add SuperEbook’s MCP server to Claude Code with one command, sign in through your browser or with an API key, and write books from notes in your project."
url: "https://www.superebook.ai/mcp/claude-code"
---

# Add SuperEbook to Claude Code

Add SuperEbook’s MCP server to Claude Code with one command, sign in through your browser or with an API key, and write books from notes in your project.

One command in your terminal, then sign in through your browser, or use an API key where there’s no browser.

## Before you start

- **A SuperEbook account with Starter, Pro or any credit pack.** SuperEbook’s Free plan doesn’t include connecting apps: [see plans](https://www.superebook.ai/pricing.md).

## Set it up

Run `claude mcp add --transport http superebook https://www.superebook.ai/api/mcp`, then /mcp → superebook → Authenticate. Without a browser, add `--header "Authorization: Bearer YOUR_KEY"` with an API key from Settings → Connect apps.

## The commands

In your project: ```
claude mcp add --transport http superebook https://www.superebook.ai/api/mcp
```

For every project: ```
claude mcp add --transport http superebook --scope user https://www.superebook.ai/api/mcp
```

With an API key, where there's no browser: ```
claude mcp add --transport http superebook https://www.superebook.ai/api/mcp --header "Authorization: Bearer YOUR_KEY"
```

## Server URL

`https://www.superebook.ai/api/mcp`

Use it exactly as shown, with www.

## What your app can do

- `get_account` (Account and prices): Your plan, your credit balance, what each format costs to write and how much apps can still start today.
- `list_books` (List books): Your books, the most recently changed first, each with its stage: draft, planning, planned, writing, ready or failed.
- `create_book` (Create a book): Starts a book from your idea and any notes you paste, and plans it for free: title ideas, a short brief and the chapters.
- `plan_book` (Plan again): Plans a book again: all of it, the titles only or the chapters only. Free, up to 15 plans a day and 5 for any one book.
- `get_plan` (Show the plan): The title, the brief and the chapters, with the price to write the book and your balance.
- `edit_plan` (Edit the plan): Changes the title, subtitle, brief or chapters before a word is written.
- `start_writing` (Write the book): Writes the book once you’ve agreed to its price. The only tool that spends credits.
- `get_progress` (Check progress): How far writing has got: the step it’s on, the chapters done and roughly how long is left.
- `get_download_links` (Get download links): PDF, EPUB and DOCX links for a finished book, plus its cover, each working for 15 minutes.

## Credits

Planning is free. Writing costs the same credits as in SuperEbook: Lead Magnet 25, Research Report 30, How-To Guide 35, Interactive Workbook 35, Course Companion 45. Web research adds 5.

## Limits for connected apps

- Books apps can start writing: 5 books, or 150 credits’ worth, in any 24 hours.
- Drafts apps can create: 20 a day.
- Notes you paste: 100,000 characters a book; add longer files in SuperEbook itself.
- Plans: 15 a day, and 5 for any one book: SuperEbook’s own limit.
- Requests: 60 a minute for each connection, 600 an hour for your account.
- Download links: 60 an hour; each link works for 15 minutes.
- API keys: 5 at a time, and 10 new ones an hour.
- Connected apps: 20 at a time; connecting one more disconnects the oldest.

## If it doesn’t work

| What you see | Code | What to do |
| --- | --- | --- |
| /mcp shows superebook isn’t signed in |  | Choose Authenticate again. It happens after you disconnect it in Settings, after 30 days unused, or after Claude Code signs in on another computer. |
| It can’t connect with a key |  | Check that the whole key follows “Bearer ” in the header, and that it isn’t revoked in Settings → Connect apps. A revoked key stops at once; make a new one. |
| The browser page says “This link doesn’t work” |  | Run /mcp, pick superebook and choose Authenticate again: a sign-in link works once, within 30 minutes. |
| “You can have 5 keys.” |  | Revoke a key you no longer use in Settings → Connect apps, then create another. |

For credits, limits and the other messages an app may relay, see [if something goes wrong](https://www.superebook.ai/mcp#troubleshooting).

## Questions

**Should I sign in or use an API key?** Sign in if the computer has a browser: there’s no key to keep safe. Use a key on a server or over SSH, or when you use Claude Code on more than one computer.

**Where does Claude Code keep my key?** In its settings file on your computer, ~/.claude.json, for a server added for you or for one project. SuperEbook keeps only a one-way hash of the key and can’t show it again: if you lose it, revoke it and make a new one.

**Does writing stop when Claude Code exits?** No. Writing runs on SuperEbook and takes 10 to 40 minutes. Ask Claude Code how far it has got next time, or open the book in SuperEbook.

**How do I remove it?** Run claude mcp remove superebook. That deletes the sign-in Claude Code kept on your computer; to end the connection on SuperEbook’s side too, disconnect it in Settings → Connect apps.

## Checked against Anthropic’s docs on October 18, 2026

- [Connect Claude Code to tools via MCP](https://code.claude.com/docs/en/mcp): Claude Code’s docs on adding a remote server, its scopes, signing in with /mcp, and removing a server.

## More about connecting

- [Claude app](https://www.superebook.ai/mcp/claude-app.md)
- [Cursor](https://www.superebook.ai/mcp/cursor.md)
- [VS Code](https://www.superebook.ai/mcp/vscode.md)
- [GitHub Copilot](https://www.superebook.ai/mcp/github-copilot.md)
- [Codex](https://www.superebook.ai/mcp/codex.md)
- [Gemini CLI](https://www.superebook.ai/mcp/gemini-cli.md)
- [Zed](https://www.superebook.ai/mcp/zed.md)
- [Devin Desktop](https://www.superebook.ai/mcp/devin-desktop.md)
- [Other apps](https://www.superebook.ai/mcp/other-apps.md)