scrivener-mcp
Local MCP server that exposes Scrivener projects to AI clients, enabling project creation, binder navigation, document read/write, and metadata updates without opening Scrivener.
Caution. Specific findings reduced this grade. They are listed on the page. Grades reflect the full trust pyramid: code, verification depth, and reputation. New projects cap at C until adoption is earned.
How we verified
Verified is a snapshot. Live keeps it current, and builds your track record.
⚡ Connect GitHub → continuous verification on every pushwhy connect →Who stands behind it
sschmitt-cg
Source: Glama
Claim it to get a verified publisher badge, a free copy of our full audit findings, and direct contact for any high-priority issues we find. Or connect your repo for our deepest verification, Live Monitored: read-only, revoke anytime. What we access →
Install from
The grade above is for the source repository. Registries can serve a different version, so we mark the ones we were not able to read.
These names and descriptions are the publisher's own, read from the source code. We print them as written. Our assessment is the findings above, not this list.
list_projectsLists all Scrivener projects (.scriv packages) in the configured projects directory.
open_projectOpens a Scrivener project by name, making it the active project for all other tools.
create_projectCreates a new Scrivener project with full binder structure, labels, statuses, and optional initial content. The new project becomes the active project. Use this to scaffold a writing project from an idea: define the manuscript structure as a hierarchy of Folders (acts/parts/chapters) and Text items…
list_documentsReturns the flattened binder of the active project with label and status names resolved.
get_documentReturns metadata and plain text content for one document.
write_documentWrites new plain text content to an existing document. The UUID must already be in the binder (use add_document to create a new document). The call will fail with a clear error if Scrivener has the project open — close Scrivener first.
update_metadataUpdates title, synopsis, label, status, or includeInCompile for a document. Will fail with a clear error if Scrivener has the project open — close Scrivener first.
batch_update_metadataBatch version of update_metadata. Applies many metadata changes in a single .scrivx write, reducing the conflict window and the per-call overhead. Each entry has the same {uuid, changes} shape as update_metadata. UUIDs not found in the binder are reported in the response rather than throwing. Will f…
search_documentsSearches title and synopsis across all binder items in the active project.
get_outlineReturns the binder as a nested tree with synopses, labels, and statuses — the single best tool for understanding a project's structure before suggesting or making changes. Each node corresponds to a Scrivener index card. The synopsis is what appears on the corkboard. Use this to see the story shape…
get_documentsBatch version of get_document. Returns metadata and plain text content for many documents in a single call. Use this when you need the prose for several specific documents (e.g. the previous three scenes for continuity, or every Text item with a particular label). Cheaper than calling get_document …
add_documentAdds a new document or folder to the binder of the active project. Will fail with a clear error if Scrivener has the project open — close Scrivener first. Use this to extend the structure of an existing project: add a new scene to a chapter, a new chapter to an act, a new research note, or a whole …
move_documentMoves a binder item to a different parent folder. Will fail with a clear error if Scrivener has the project open — close Scrivener first. Use this to restructure the project: move a scene from one chapter to another, promote a scene to chapter level, reorganise acts, or move a document into the Res…
Disclosed vulnerabilities in this server's declared npm dependencies (via OSV). Whether each is reachable depends on the installed versions.
Model Context Protocol (MCP) TypeScript SDK does not enable DNS rebinding protection by default
SCRIV_DIRPath to a directory containing .scriv packages. Enables list_projects, open_project, and create_project.SCRIV_PATHPath to a single .scriv package. Opens it immediately on startup.SCRIV_PLATFORMmac (default) or windows. Controls the RTF format used when writing document content.Tool annotations
No tools have read-only/destructive annotations
Add readOnlyHint or destructiveHint annotations to every tool so hosts can warn users before invoking.
All four hints declared on every tool
13/13 tools missing one or more hints — list_projects (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint); open_project (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint); create_project (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint), +10 more. OpenAI's directory rejects tools where any of the four hints are missing or non-boolean.
For every tool, set all four hints (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) to explicit true/false values that match the handler’s actual behaviour.
License file
No license file
Add a LICENSE file (MIT, Apache-2.0, etc.).
Tool test coverage
Only 1/13 tools referenced in tests (8%)
Write tests that reference each tool by name so every tool has at least one test.
Production dependencies are patched
0 critical, 1 high severity in production deps — @modelcontextprotocol/sdk@1.0.0 (high)
Run npm audit fix, or upgrade the affected packages to a non-vulnerable version.
Claim the listing to review these findings one by one and send us a correction where you disagree, straight to the team. Claiming also means we tell you when the grade moves, and reach you first if we find anything urgent.
[](https://m8ven.ai/mcp/sschmitt-cg/scrivener-mcp)?variant=verified from the URL.Vetting this one by hand? Tool Check is an MCP that scores other MCPs. Add it once and ask Claude, ChatGPT, or any MCP client to grade a server, surface CVEs, check the publisher, and suggest safer alternatives — before you install.
https://m8ven.ai/api/mcp/tool-check