How the Skills and the MCP server work
Two separate pieces let an AI tool such as Claude Code work on your book. It helps to know which one does what, because they promise different things.
The MCP server: the door
NovelOS has a small server built in, switched on in Settings › MCP. While it runs, an AI tool on the same computer can ask NovelOS for parts of your book and, if you allow it, change them. It is the only way in: the tool doesn't open your files or your database.
What a tool can read, in the books you share: the book list and each book's overview and statistics, chapters (a page of paragraphs at a time, each with its number), search across the manuscript, comments, notes and bookmarks, characters, places and items, lore, plot boards, scenes, the timeline, the family tree, Spark boards, chapter snapshots, saved searches, book layout, writing history, pictures and maps.
What a tool can change, when Allow edits is on: chapters (create, rename, move, delete, replace or insert paragraphs, style a paragraph), comments and bookmarks, characters, places, lore, scenes and their place on the timeline, plot boards and their cards, Spark boards and cards, pictures and map labels, the family tree, snapshots, saved searches, export presets and the book overview. It can also create a new book and export a book file in the formats your licence includes.
What NovelOS itself guarantees:
- Only shared books. Under Permissions you choose all books or only some. A tool asking for any other book gets told there's no such book.
- Read-only when you say so. Turn off Allow edits and the editing tools vanish from what the tool is offered. A tool that tries anyway is told edits are turned off.
- Everything is logged. Every call, read or write, goes into Settings › MCP › Activity, with the tool's name and the time.
- Every change can be undone, one at a time, a session at a time, or all at once.
- A snapshot before the first text edit. The first time a tool changes the text of a chapter in a session, NovelOS saves a snapshot of that chapter named "Before AI edit" with the tool's name.
- No overwriting your fresh words. When a tool replaces paragraphs it must say which version of each paragraph it read. If you've typed in one of them since, nothing changes and the tool is told to read again.
- Your Muse keys stay put. API keys for Muse are never shared with AI tools.
The Skills: the manners
A skill is a page of written instructions the AI tool reads before it starts a job. NovelOS comes with seven: Beta reader, Chapter summary, Character voice, Continuity check, Scene outline, Timeline and World bible sync. Each one says which NovelOS tools to use, in what order, and how to behave:
- Quote the passage it's talking about, with the chapter and paragraph number.
- Propose, don't rewrite. None of them drafts your prose unless you ask.
- Show you exactly what it wants to save (a comment, a scene card, a character entry) and wait for your yes.
- Never invent facts about your story. If the book doesn't say, the skill says it's unknown.
The difference that matters
"Ask first" is a rule in the Skills. The AI tool follows it because it was told to, not because NovelOS can stop it. If you ask the tool, without a skill, to tidy up chapter 4, it can go ahead and edit chapter 4.
The hard limits are the ones NovelOS enforces: shared books, the Allow edits switch, the log, undo and the snapshot. So the honest summary is: the Skills propose, you approve, and NovelOS lets you take anything back.
If you want a tool to look and never touch, turn off Allow edits. Some tools, Claude Code among them, also ask your permission before using a NovelOS tool. That's the tool's own check, and a second chance to say no.
What you need
- NovelOS Studio on a desktop computer, with the full version. In the trial the server stays off.
- An AI tool that runs on your computer: Claude Code, Codex, Cursor or Claude Desktop. ChatGPT or claude.ai in a browser can't reach NovelOS, though the Skills still work on text you paste there.
- NovelOS open while you work. The server only runs while the app does.
Next: Connect your AI tool
Checked against NovelOS Studio 1.5.1 · Updated · View as Markdown