MCP tools

The core editor exposes 61 MCP tools. The Publish plugin adds 29 more (21 publishing and scheduling tools plus 8 newsletter tools), and the GitHub plugin adds 6. Any MCP-compatible agent can use these to create, edit, and manage documents.

Setup

Claude Code

npx openwriter setup

Any MCP agent

{
  "mcpServers": {
    "openwriter": {
      "command": "openwriter",
      "args": ["--no-open"]
    }
  }
}

Core tools (61)

Document operations

Create, populate, list, switch, delete, archive, and unarchive documents. Reload a document from disk.

create_document, populate_document, declare_writes, open_file, list_documents, switch_document, delete_document, archive_document, unarchive_document, reload_from_disk

Reading

Read the pad, check its status, and look at a document’s outline or individual nodes.

read_pad, get_pad_status, outline_doc, peek_doc, get_nodes

Text editing

Write to the editor pad and edit text with pending change decorations.

write_to_pad, edit_text

Workspace management

Create and manage workspaces with nested containers.

list_workspaces, create_workspace, delete_workspace, get_workspace_structure, get_item_context, update_workspace_context, create_container, delete_container

Organization

Tag documents, move them between containers, and rename them.

tag_doc, untag_doc, move_item, rename_item

Versioning

Create checkpoints, list versions, restore to a previous state.

list_versions, create_checkpoint, restore_version

Metadata

Get and set document metadata such as title, description, tags, author, slug, date, and draft status.

get_metadata, set_metadata

Attribution

See how much of a document was written by you and how much by an agent.

get_attribution

Manuscript

Compile a book outline into a Manuscript, add chapters to it, make an editing draft, and export the book.

compile_manuscript, export_manuscript, add_chapter_to_manuscript, create_editing_draft

Comments and agent marks

Read and resolve comments and agent marks left on a document.

get_comments, resolve_comments, get_agent_marks, resolve_agent_marks

Tasks

Keep a task list alongside your documents.

list_tasks, add_task, update_task, remove_task

Search documents, link them to each other, and explore how they connect.

search_docs, browse_docs, crawl, link_to, get_doc_link, get_graph

Enrichment and sorting

Refresh document summaries and file documents you marked for sorting.

claim_enrichment, mark_enriched, list_dirty_docs, list_pending_sorts, propose_sort, mark_sorted

Images

insert_image generates an image with Gemini. Three modes: insert it inline in a document, set it as the article cover (set_cover), or write it to disk only and return the path. It uses your own Gemini key. See Image Generator.

Import

Import a Google Doc.

import_gdoc

Publish plugin tools (29)

Account and billing

request_login_code, verify_login, get_billing, upgrade_plan, manage_billing

Connections and posting

list_connections, post_to_x, post_to_linkedin

Scheduler

schedule_post, list_schedule, manage_schedule

Slots

list_slots, create_slot, edit_slot, delete_slot, naturalize_slots

Autoplugs

manage_autoplugs, list_autoplug_tracking

Custom sending domain

setup_custom_domain, check_domain_status, resend_domain_verification

Newsletter

send_newsletter, list_subscribers, add_subscriber, import_subscribers, resend_to_unopened, list_newsletter_issues, get_newsletter_analytics, get_subscribe_embed

See Scheduler and Newsletter.

GitHub plugin tools (6)

inspect_blog_repo, add_blog_site, list_blog_sites, edit_blog_site, remove_blog_site, post_to_blog

See GitHub.

Compatible agents

  • Claude Code — one-command skill install
  • Cursor — add MCP config to settings
  • Windsurf — add MCP config to settings
  • VS Code — via MCP extension
  • Any agent that supports the Model Context Protocol

Multi-session

Multiple agents can work simultaneously on different documents. Each session is isolated.