What it does

A local MCP server that teaches Claude and OpenCode to manage Narrarium book repositories. It provides 80 tools for scaffolding book repos, creating story entities (chapters, characters, locations, factions, items, secrets, timeline events), searching canon, validating metadata, and enriching narratives with Wikipedia research. The server treats the repository structure itself as the book, enforcing a strict but extensible convention for organizing narrative artifacts into a searchable, version-controllable archive.

Who it's for

Authors and fiction writers who want to keep book artifacts in their filesystem rather than a SaaS platform, especially those building complex narratives with rich world-building, character systems, and spoiler-safe lore. Useful for writers who collaborate with Claude through code editors like OpenCode and want their assistant to understand and respect the repository's internal canon and metadata structure.

Common use cases

Scaffold a new Narrarium book repository with starter templates and interactive setup
Create and organize story entities (chapters, characters, locations, factions) in structured format
Validate book repository metadata, cross-references, and narrative consistency
Search existing canon while writing new content to avoid contradictions
Export completed manuscripts to EPUB with spoiler-safe rendering modes
Fetch and integrate Wikipedia research context directly into worldbuilding workflows

Setup pitfalls

Requires the book repository to follow Narrarium's strict directory and metadata conventions—use npx create-narrarium-book to scaffold compliant repos rather than converting existing ones manually
The optional Astro reader scaffold requires separate npm install and build steps; it is not included by default when running the MCP server alone
Makes network calls for Wikipedia research—ensure your environment can reach external APIs or disable research fetching if offline
The project has no CI configured and receives frequent commits; test in a non-critical repo first

Tool name

Description

Destructive?

init_book_repo

✓ no

setup_framework

✓ no

repository_spec

✓ no

start_wizard

✓ no

wizard_answer

✓ no

wizard_status		✓ no
wizard_finalize		✓ no
wizard_cancel		✓ no
character_wizard		✓ no
create_character		✓ no
location_wizard		✓ no
create_location		✓ no
faction_wizard		✓ no
create_faction		✓ no
item_wizard		✓ no
create_item		✓ no
secret_wizard		✓ no
create_secret		✓ no
timeline_event_wizard		✓ no
create_timeline_event		✓ no
chapter_wizard		✓ no
paragraph_wizard		✓ no
chapter_writing_context		✓ no
paragraph_writing_context		✓ no
revise_chapter		✓ no
revise_paragraph		✓ no
review_dialogue_action_beats		✓ no
resume_book_context		✓ no
create_entity		✓ no
create_chapter		✓ no
create_paragraph		✓ no
create_chapter_draft		✓ no
update_chapter_draft		✓ no
update_book_notes		✓ no
save_book_item		✓ no
save_chapter_item		✓ no
update_chapter_notes		✓ no
promote_book_item		✓ no
promote_chapter_item		✓ no
create_paragraph_draft		✓ no
update_paragraph_draft		✓ no
create_chapter_from_draft		✓ no
create_paragraph_from_draft		✓ no
create_asset_prompt		✓ no
register_asset		✓ no
generate_asset_image		✓ no
update_chapter		✓ no
update_paragraph		✓ no
apply_dialogue_action_beats		✓ no
search_book		✓ no

narrarium-mcp-server

What it does

Who it's for

Common use cases

Setup pitfalls