read_annotations

MCP tool from Scrivener MCP by writerslogic

Read a document's comments and footnotes

How to use it

read_annotations is exposed by the Scrivener MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the read_annotations tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.

Install Scrivener MCP

$npx scrivener-setup

FULL SCRIVENER MCP LISTING

Other tools in Scrivener MCP (39)

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_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

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)