Docs

Try spine, credits, KDP, rewrite or narration.

    Guides

    Assistant & help

    Use IdeaToBook from Claude or ChatGPT

    Connect your IdeaToBook account to Claude or ChatGPT and work on your books from the chat: start a book, answer the interview, build the outline, write chapters and change the design. Anything that uses credits shows its cost first and waits for you.

    On this page
    #

    What you can do from the chat

    • See your books and your account: your books and the step each is at, a book's interview, outline and chapters, a chapter's text and editor notes, your plan and credit balance.
    • Start a book from an idea and get its interview questions, then answer them in the chat.
    • Build the outline, edit chapter titles, promises and points, and approve it when you're happy.
    • Write or rewrite a chapter and run the editor pass on it, then accept or dismiss each note.
    • Change the design and details: title, subtitle, author name, back-cover text, cover design and colour, interior style, trim size and paper. Every design change can be undone for 30 minutes.

    It's the same account and the same books as on the website. Whatever the AI app does shows up in IdeaToBook straight away, and you can carry on in either place. Downloads (EPUB, print PDF, Word and cover files) stay on the website, under Publish → Files.

    Any IdeaToBook plan works, Free included. On Free, the AI app can do what Free does on the site: the interview, the outline and the first chapter of each book.

    #

    Things to ask

    List my IdeaToBook books.
    Start a how-to guide in IdeaToBook about sourdough for busy parents, and show me the interview questions.
    Here are my answers to the interview: … Save them, then tell me what building the outline would cost.
    Build the outline. Then move the chapter on starters to the front.
    Write chapter 2 of The Quiet Loaf.
    Run the editor on chapter 1 and apply the notes about filler.
    Make the cover of my newest book forest green and switch the interior to a large-print style.
    Undo that cover change.
    How many IdeaToBook credits do I have left?
    Mention IdeaToBook the first time, so the app knows which tool you mean. After that, plain requests work.

    When you ask for a chapter, an outline or an editor pass, the app first tells you what it will cost and what it will replace, then asks you to confirm. See Credits.

    #

    Connect Claude

    1. In Claude on the web or in the desktop app, open Customize → Connectors. In some versions it's under Settings → Connectors.
    2. Choose Add custom connector.
    3. Name it IdeaToBook and paste the address https://ideatobook.my/mcp. Leave the advanced settings empty, then press Add.
    4. Press Connect. An IdeaToBook sign-in page opens: enter your email address, then the code we email you. No account yet? Signing in creates a Free one.
    5. Read what Claude will be able to do, then press Allow. You go back to Claude.
    6. In a chat, check that IdeaToBook is switched on in the connectors menu under the message box, then ask something such as "List my IdeaToBook books".

    Once it's added, the connector is available wherever you use that Claude account, including the mobile apps. Claude may ask your permission before it uses IdeaToBook, especially for actions that change a book.

    #

    Connect ChatGPT

    1. On chatgpt.com, open the plugins page (chatgpt.com/plugins). If there's no way to add your own, check ChatGPT's settings for Developer mode, which some plans offer.
    2. Press Add (top right), then Add custom MCP server.
    3. Enter the name IdeaToBook and the address https://ideatobook.my/mcp, keep OAuth for authentication, tick I understand and want to continue, and press Create as a plugin.
    4. Sign in to IdeaToBook with your email address and the code we email you, then press Allow.
    5. In a chat, press Plugins under the message box and choose IdeaToBook (or press Try in chat on its plugin page), then ask something such as "List my books".

    ChatGPT's menus are renamed and moved often. If these steps don't match what you see, look for adding a custom MCP server or connector in OpenAI's help pages; the address and the sign-in stay the same.

    #

    Credits

    1. You ask for something that uses AI: building the outline, writing or rewriting a chapter, or an editor pass.
    2. The app asks IdeaToBook for an estimate first. That's free: it returns the usual cost, the most that will be set aside, your balance, what the action would replace and anything your plan doesn't allow.
    3. The app shows you that and asks you to confirm. Nothing runs and nothing is charged until you do.
    4. After you confirm, it runs exactly as in the editor: about twice the usual cost is set aside, you're charged what it really cost, and the rest goes back. If it fails, nothing is charged.
    • Each confirmation works once, for that one action, book and chapter, for 15 minutes. After that, the app asks for a new estimate.
    • Free books aren't metered, as on the site.
    • Chapters written from an AI app aim for at most 2,200 words, so they finish within the app's time limit. The editor on the website can write longer chapters.
    • Reading your books, starting a book, saving answers, editing and approving the outline, accepting notes and design changes cost nothing.
    • Credits are bought only on ideatobook.my. The AI app can't buy credits or change your plan, and when you run short it says so and stops.

    What things cost is on Plans, credits and costs.

    #

    What it can't do

    • Make pictures or audio: no AI cover art, illustrations or audiobook narration. Do those on the website.
    • Buy anything, or change your plan, billing details or email address.
    • Delete books, chapters or anything else.
    • Share a book publicly, publish a storefront, start a translation or write the store listing.
    • Download your files. It gives you a link to Publish → Files instead.
    • See anyone else's books, or anything outside your IdeaToBook account.
    #

    Privacy and permissions

    When you connect an app, the consent screen names it by the web address it comes from and lists what it may do. It can ask for these permissions:

    books:read
    See your plan, credits and books, including chapter text
    books:write
    Create books, save interview answers, and edit outlines and designs. Write and review chapters after you confirm each one; these use your credits
    offline_access
    Stay connected until you disconnect it (it doesn't have to ask you again every hour)
    openid
    Know which IdeaToBook account you signed in with (not your email address)
    • What goes to the AI app, only when it asks on your behalf: your plan and credit balance, and for the books it asks about their titles, types and settings, interview questions and answers, outlines, chapter text, editor notes and links.
    • What it never gets: your email address, your name, your billing details or payment data.
    • What we receive from it: only what each action needs, such as an idea, answers, outline edits, a design change or a chapter number. We never see your conversation with the AI app.
    • What we keep: which app you connected and when, what you allowed, and its sign-in tokens. For limits and security we log each action's name, your account ID, the time and whether it worked, never its content, for up to 7 days.
    • Once the AI app has your book data, its provider's privacy policy applies (Anthropic's for Claude, OpenAI's for ChatGPT).

    The details are in our Privacy policy and Terms.

    #

    Disconnect an app

    1. Open Account on ideatobook.my.
    2. Under Connected apps, press Disconnect next to the app.

    It stops at once: its sign-in tokens are deleted and IdeaToBook refuses its requests from then on. Removing the connector in Claude or ChatGPT tidies up their side; to be sure its access is withdrawn on ours, disconnect it on your Account page too. Deleting your IdeaToBook account disconnects every app.

    #

    Troubleshooting

    The app keeps asking me to sign in again

    The connection was removed on your Account page, or it expired. Connect again from the app; your books are all still there.

    Which apps can connect?

    For now, only Claude (claude.ai) and ChatGPT (chatgpt.com). Claude Code and other tools that run on your computer can't connect yet.

    It says a confirmation has expired or was already used

    Confirmations last 15 minutes and work once. Ask again and the app gets a fresh estimate.

    It says I don't have enough credits

    The action needs more credits than your balance. Add credits on ideatobook.my, or ask the app for something that costs less. On Free books, chapters after the first need credits or a paid plan.

    A chapter is "still being written"

    Long chapters can outlast the app's time limit. The writing carries on: ask the app to check the chapter again in half a minute. If the writing was cut off, the credits set aside are given back automatically later.

    It says another chapter is being written

    One chapter at a time per book. Wait until it's done, or work on another book.

    It says I've made too many requests

    To keep things fair, an account can make 300 requests an hour from AI apps, run 30 credit-using actions an hour, and start 20 books a day. The message says when you can carry on.

    The app changed something I didn't want

    Design changes can be undone for 30 minutes: ask the app to undo it. Everything else can be edited on the website. Text a rewrite replaced can't be brought back, which is why rewrites always show what they replace and wait for you.

    Still stuck? Use Help & feedback or email support@ideatobook.my, and tell us which app you use and what you asked. See Help, feedback and bug reports.

    #

    Every tool the app can use

    These are the 17 tools IdeaToBook offers AI apps, exactly as the server lists them. The app picks the right one from what you ask; you don't need their names.

    ToolWhat it doesReads or changesUses credits
    get_accountGet account. The signed-in IdeaToBook account: plan, credit balance (plan and pack credits), books started this month and the plan's limit, and which features the account includes (translations and audiobook narration work with any credits; they use credits like other AI work). Never includes the email address or billing details.Reads onlyNo
    list_booksList books. The account's books, newest activity first: id, title, type, step (interview, outline or writing), chapters written and approved, approximate words, and a link to each book.Reads onlyNo
    get_bookGet book. One book: its step, design settings, interview questions and answers, outline, and chapter list (status, words, open editor notes, whether a write is in progress), with links to the editor and to Publish → Files.Reads onlyNo
    get_chapterGet chapter. One chapter's text, up to 12,000 characters per call (pass offset for the next part), its open editor notes, and whether a write is in progress, done or failed.Reads onlyNo
    list_design_optionsList design options. The design choices update_design accepts: interior styles (with fonts, and whether the book's plan includes each), cover designs, cover colours, trim sizes, paper, and translation languages. Give book_id to see what that book's plan includes.Reads onlyNo
    estimate_actionEstimate an AI action. Checks an AI action before it runs and returns its credit cost: the typical charge, the most that is reserved, the balance, what it would replace, any plan limit that blocks it, and a confirm_token. Charges nothing. Actions: build_outline (needs 3+ interview answers), write_chapter (writes or rewrites one chapter), review_chapter (line-edit notes on one written chapter), review_big_picture (a big-picture review of one written chapter: pacing, structure, opening, ending, promise, repetition and continuity with the other chapters), review_book (the whole book: arc, balance, repeated material, continuity, pacing, promises and suggested changes; needs 2+ written chapters; no chapter). The token is valid 15 minutes, once, for this account, action, book and chapter only.Reads onlyNo
    create_bookCreate book. Starts a new book from an idea and a book type, and returns its interview questions (about six). Counts toward the plan's monthly book limit. Book types: guide (How-to guide), selfhelp (Self-help), business (Business book), memoir (Memoir), biography (Biography & history), faith (Faith & spirituality), cookbook (Cookbook), workbook (Workbook), journal (Guided journal), leadmagnet (Lead magnet), novel (Novel), fantasy (Fantasy & sci-fi), romance (Romance), thriller (Mystery & thriller), stories (Short stories), kids (Children's book), poetry (Poetry), other (Something else). Calling it twice makes two books.Adds something newNo
    save_interview_answersSave interview answers. Saves answers to a book's interview questions by question_id (from create_book or get_book). Each answer replaces any earlier answer to that question. Only before writing starts.Changes or replaces what's thereNo
    build_outlineBuild outline. Writes the book's outline (title, subtitle, chapters with promises and points) from its interview, replacing any existing outline. Needs 3+ answered questions. Uses credits on paid books; requires the confirm_token from estimate_action with action build_outline for this book.Changes or replaces what's thereOn paid books, after you confirm
    update_outlineUpdate outline. Edits a built outline before it's approved: the book's title, subtitle, and the full chapter list (each with a title, and optionally a promise and up to 8 points). A chapters list replaces all chapters, in order; leave it out to keep them. Up to 60 chapters.Changes or replaces what's thereNo
    approve_outlineApprove outline. Approves the book's outline and starts the writing step. This is one-way: afterwards the interview and the outline can't be changed (chapter text can still be written, rewritten and edited).Changes or replaces what's thereNo
    write_chapterWrite chapter. Writes one chapter from the approved outline, or rewrites it if it already has text (a rewrite replaces the text, clears its open notes and counts toward the plan's rewrite limit; an optional instruction says how to change it). Chapters written from AI apps aim for at most 2,200 words. Uses credits on paid books; requires the confirm_token from estimate_action with action write_chapter for this book and chapter. Usually finishes within the call (status "drafted"); if it takes longer it returns status "writing", and get_chapter reports when it's done. One write at a time per book.Changes or replaces what's thereOn paid books, after you confirm
    review_chapterReview chapter. Runs the editor on one written chapter. pass line_edits (default): up to six notes (fact, filler, repetition, clarity, voice), each quoting the text with a suggested fix; replaces the chapter's open line-edit notes. pass big_picture: a short summary and up to six notes on whole passages (pacing, structure, opening, ending, promise, repeated, continuity), each with quote and quote_end and a direction; replaces the chapter's open big-picture notes. Uses credits on paid books; requires the confirm_token from estimate_action with action review_chapter (line_edits) or review_big_picture (big_picture) for this book and chapter.Changes or replaces what's thereOn paid books, after you confirm
    review_bookReview the whole book. Runs the whole-book review: the editor reads the outline and a short summary of every written chapter (2+ needed) and reports on the arc, chapter balance, repeated material, continuity, pacing, promises not kept and suggested changes, and places up to 12 notes on specific passages in the chapters (replacing the last whole-book review's open notes). Uses credits on paid books; requires the confirm_token from estimate_action with action review_book for this book. Takes a minute or two: it usually finishes within the call (status "done"); otherwise it returns status "running" and a job_id, and calling review_book again with that job_id (no confirm_token) returns the report when it's ready.Changes or replaces what's thereOn paid books, after you confirm
    resolve_editor_noteAccept or dismiss an editor note. Resolves one open editor note (ids from get_chapter or review_chapter). accept replaces the quoted passage in the chapter with the note's suggestion; dismiss keeps the text as it is.Changes or replaces what's thereNo
    update_designUpdate book design. Changes a book's details or design at once: title, subtitle, author name, back-cover text, cover design, cover colour (#RRGGBB or a palette name), cover kicker, title placement on an AI-art cover, interior style (fonts come with it), trim size or paper. Values must come from list_design_options. Send only the fields to change. Returns an undo_id that works for 30 minutes.Changes or replaces what's thereNo
    undo_design_changeUndo a design change. Reverts one update_design change by its undo_id, once, within 30 minutes. Fields changed again since then are kept and listed as skipped.Changes or replaces what's thereNo
    Was this helpful?

    Found a mistake? · Help & feedback

    Help & feedback

    Talk to the people who make IdeaToBook. A person reads every message.

    Have an account? See your messages. Or email support@ideatobook.my.