Holonovel
Run tabletop RPG worlds with rooms, a parser and Fate, Ironsworn and Blades rules
- Pricing
- Open source
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 2026.11.8
- Listing updated
- today
Similar MCP servers
About Holonovel
Holonovel is an open-source MCP server for games and play. It runs locally on your machine and is started by your AI client.
State is the point: worlds are kept as structured save files called Novels, with atomic saves, per-badge undo and redo snapshots and an append-only audit log, stored in your user-data folder or wherever TTRPG_DATA_DIR points. A fresh install is playable immediately, seeding a tutorial Novel called Torre Nosferatu that open_session resumes in one call.
The server exposes 36 action-based tools grouped into badges and workflow, characters and cast, world and scene, narrative, session, mechanics and content. Built-in mechanics cover Fate dice, Ironsworn momentum and Blades in the Dark stress, and further ruleset packages load beside the base without modifying it. Switches control NPC autonomy, world reactivity, narration grounding validation and deterministic seeding.
It requires Node.js 22 or newer and is MIT licensed. The README credits a long list of SRDs and open resources, including Fate, Ironsworn, Blades in the Dark and Dungeon World.
Install
Run in a terminal
claude mcp add holonovel -- npx -y holonovelAdd to claude_desktop_config.json
{
"mcpServers": {
"holonovel": {
"command": "npx",
"args": [
"-y",
"holonovel"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"holonovel": {
"command": "npx",
"args": [
"-y",
"holonovel"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"holonovel": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"holonovel"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"holonovel": {
"command": "npx",
"args": [
"-y",
"holonovel"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"holonovel": {
"command": "npx",
"args": [
"-y",
"holonovel"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- open_session
- Resume or open a session and the active Novel.
What it does
- Persistent worlds
- Novels save rooms, things, exits and story state with undo and redo.
- Parser command layer
- Text-adventure style commands over the world model.
- Built-in mechanics
- Fate dice, Ironsworn momentum and Blades stress tracks.
- Ruleset packages
- Install extra rulesets alongside the base.
- Tutorial included
- A starter Novel is seeded on first run.
- NPC and world switches
- Optional autonomy and reactivity behaviours.
Good for
- Run a solo or GM-assisted tabletop session with an AI
- Keep a campaign's world and cast consistent across sessions
- Resolve Fate or Ironsworn rolls through tools
- Add a rulebook as a package and play it
Pricing
Open source
MIT licence
Holonovel FAQ
Do I need a rulebook?
No, the base works without one and starts with a tutorial.
Where is campaign data stored?
In the OS user-data folder, or the path in TTRPG_DATA_DIR.
How many tools are there?
36 action-discriminator tools.
What does it need?
Node.js 22 or newer.
Is Holonovel free?
Yes. Holonovel is open source, so you can use and self-host it for free.
How do I add Holonovel to Claude Code?
Run this command in your terminal: claude mcp add holonovel -- npx -y holonovel
What are the best alternatives to Holonovel?
The closest alternatives to Holonovel are Digimon, Disney, Clash Royale, 82-0 Dream MCP and 27-0 MCP.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

