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:

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:

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

Next: Connect your AI tool

Checked against NovelOS Studio 1.5.1 · Updated · View as Markdown