How do I connect Scrivener MCP Server to Claude?

Run `claude mcp add scrivener-mcp -- npx -y scrivener-setup` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.

Is Scrivener MCP Server free?

The listed licence is AGPL-3.0. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.

What can Scrivener MCP Server do?

Scrivener MCP Server documents 40 tools to the agent, including analyze_document, analyze_writing_style, check_consistency. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.

Scrivener MCP

Unclaimed

by writerslogic

The definitive MCP server for Scrivener — connect your novels, screenplays, and manuscripts to Claude, ChatGPT, and any AI assistant. 53 tools: document management, writing analysis, content enhancement, offline semantic search, and character/plot tracking.

Set up this server

Compare servers My Stack

01 / Choose your client

02 / Before you connect

Authentication is not specified. Check the project instructions before connecting.

Install the runtime required by the project and make it available to your client.

Project instructionsEnvironment variable names (optional)

Use names from the project instructions, separated by commas. Enter names only, never secret values.

03 / Add the configuration

Source: generated from public install instructions

claude mcp add --transport stdio 'scrivener-mcp' -- 'npx' '-y' 'scrivener-setup'

Run in your terminal after replacing any placeholders.

04 / Check it in your client

Open your client’s MCP settings and confirm the server connects and lists its tools. A copied configuration does not confirm a working connection.

ai-writingchatgptclaudecontent-analysiscopilotcreative-writingcursormanuscriptmcpmcp-servermodel-context-protocolnovelscrivenerscrivener3semantic-searchwritingwriting-toolwriting-tools

Is this your MCP server?

This listing was auto-indexed from the public record. Claim it to edit the page, set compatibility and unlock growth tools. Takes under two minutes.

Claim this server

Security profile

Claimed and verified servers get a weekly static scan that shows what the code can reach: external services, environment variables, shell commands, agent configuration folders, plus any dependencies with known advisories. Claim this listing to get one. How the security profile works

40 of 40 tools

Documented tools (40)

From project documentation. A server handshake does not verify each tool’s description or behavior.

analyze_document

AI writing analysis; focus with aspects (structure, style, pacing, themes...)

analyze_writing_style

Style-focused analysis

check_consistency

Project-wide continuity check; scope for plot, characters, or timeline

check_plot_consistency

Plot-thread consistency check

close_project

Close the active project and flush pending changes

collect_feedback

Record a rating/comment on an AI operation to inform those insights

compare_snapshot

Diff a snapshot against the current document (or another snapshot): paragraphs added/removed and net word change

compile_documents

Combine documents; mode: "structured" compiles the Draft folder with the binder hierarchy as headings and honors "Include in Compile" (no AI), mode: "intelligent" for AI-optimized output

create_document

Create a new text document or folder

create_snapshot

Take a Scrivener-native snapshot of a document (restorable from Scrivener's own Snapshots browser) before editing

delete_document

Move to trash (reversible)

detect_open_project

Detect the project currently open in the Scrivener app (macOS) so you don't need a path

discover_projects

Scan common locations for Scrivener projects when you don't know the path

enhance_content

Suggest a specific improvement to a document

export_project

Write the manuscript to disk -- Markdown, HTML, JSON inline, or DOCX, EPUB, PDF as a file

find_mentions

Locate every occurrence of a specific name or term, with context

generate_content

Generate new prose from a prompt and context

get_compile_settings

Read the project's compile formats and taxonomy -- labels/statuses (with colors), collections, section types

get_document_info

Metadata for one document (title, type, word count, synopsis, label, status)

get_manuscript_briefing

One "where am I?" snapshot: words vs. target (% to goal), document/status/label counts, longest/shortest documents

get_structure

Browse the binder hierarchy (folders, documents, word counts)

get_writing_goals

List goals with progress -- percent complete, words remaining, on-pace status

get_writing_preferences

Show current preferences plus feedback insights and suggestions

list_snapshots

List Scrivener snapshots (title, date) for one document or the whole project

list_trash

List trashed documents

move_document

Reorganize within the binder

open_project

Open a .scriv project (accepts .scriv folders or .scrivx files) and make it active

read_annotations

Read a document's comments and footnotes

read_document

Read content; format: "formatted" for rich text, offset/limit to page long docs

read_snapshot

Read a snapshot's text as plain text, with word count

refresh_project

Reload from disk after external edits

restore_document

Restore a document from trash

search

Keyword/full-text search; field: "title" for titles, scope: "trash" for trash

semantic_search

Find passages by meaning using the local HMS index plus provider-backed query interpretation, with similarity scores

set_writing_goal

Set a word-count goal (daily, weekly, or whole project) with an optional target date

set_writing_preferences

Set author preferences (tone, complexity, length, POV, style guide) that steer AI output

suggest_improvements

AI-generated improvement suggestions

update_document

Change title and/or metadata (synopsis, notes, label, status, custom fields)

verify_project_integrity

Read-only scan for structural problems (missing/duplicate UUIDs, unreadable content)

write_document

Replace a document's content (atomic, with pre-write backup)

Tool change history

Compared across complete checks of the same configuration. Tools were listed, not invoked. Input-schema changes are not measured here.

No complete tool checks yet.

FAQ

Questions about Scrivener MCP Server

How do I connect Scrivener MCP Server to Claude?: Run `claude mcp add scrivener-mcp -- npx -y scrivener-setup` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.
Is Scrivener MCP Server free?: The listed licence is AGPL-3.0. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.
What can Scrivener MCP Server do?: Scrivener MCP Server documents 40 tools to the agent, including analyze_document, analyze_writing_style, check_consistency. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.