Skip to main content
Glama

Syncpen MCP Server

Connect Claude Code (or any MCP client) to your Syncpen workspace — the writing workspace your AI can actually write in. Your agent can search, read, draft, suggest, comment, organize, and publish in the same live documents you edit.

Don't have an account yet? Create one free at syncpen.io.

What is Syncpen great at?

  • Build a knowledge base your AI maintains — capture notes, docs, and clips, then let your agent organize, cross-link, and keep it current.

  • Write long-form where you publish — articles, docs, whole books; your agent drafts, you approve, and one call ships it to WordPress, Ghost, or Sanity.

  • Your agents and you on one project — everyone works in the same live documents; every edit is shared, legible, and attributed.

  • Edits with a paper trail — agents propose changes as signed suggestions you accept or reject. Nothing changes silently.

  • Research → draft → ship without leaving your tools — clip sources, let your AI draft from them, publish.

Related MCP server: wizard-connector

Quick Setup

1. Generate an API Key

  1. Go to Settings → API Keys in your Syncpen account

  2. Enable API Access

  3. Create a new API key

  4. Copy the key (you'll only see it once!)

2. Configure Claude Code

Add to your MCP configuration file (~/.mcp.json or project-level .mcp.json):

{
  "mcpServers": {
    "syncpen": {
      "command": "npx",
      "args": ["-y", "syncpen-mcp"],
      "env": {
        "SYNCPEN_API_KEY": "sp_your_api_key_here"
      }
    }
  }
}

That's it! Claude Code will automatically download and run the MCP server.

Available Tools

Tool

Description

syncpen_search

Search documents by title and body content (full text)

syncpen_read

Read a document's content as markdown

syncpen_list_folders

List all folders

syncpen_list_documents

List documents, optionally by folder

syncpen_create

Create a new document — personal by default, or in a team space via teamId

syncpen_update

Update a document's title and/or content

syncpen_suggest_edit

Propose an edit as a pending suggestion a human accepts/rejects (doc unchanged until accepted)

syncpen_list_suggestions

List a document's pending (or all) suggestions

syncpen_list_comments

Read comment threads (with replies, line numbers, authors)

syncpen_reply_comment

Reply to a comment thread (signed, notifies @mentions)

syncpen_resolve_comment

Mark a comment thread resolved

syncpen_move_document

Move a document into a folder, or to the root

syncpen_delete_document

Delete a document (moved to trash)

syncpen_create_folder

Create a folder (optionally nested)

syncpen_rename_folder

Rename a folder

syncpen_move_folder

Move a folder under a new parent, or to the root

syncpen_delete_folder

Delete a folder and its contents (moved to trash)

syncpen_publish

Publish a document to WordPress, Ghost, or Sanity

syncpen_list_connections

List connected CMS targets and their connectionIds — personal by default, or scoped to a team via teamId/documentId

syncpen_list_teams

List your team spaces (id, name, role, member count)

syncpen_recent_changes

A time-ordered feed of who created/edited/trashed which documents, and when

syncpen_related

Given a document, suggest what else to read — blends co-access (docs worked on together) with the /editor links

syncpen_drive_list_files

List/search files in the user's connected Google Drive

syncpen_drive_read_file

Read a Drive file's content (Google Docs and plain text files only)

syncpen_news_search

Search recent world news via the user's connected World News API key

syncpen_slack_list_channels

List public channels in the user's connected Slack workspace

syncpen_slack_read_channel

Read a public Slack channel's recent message history

syncpen_notion_search

Search pages in the user's connected Notion workspace

syncpen_notion_read_page

Read a Notion page's top-level content

Usage Examples

Once configured, ask Claude Code:

  • "List my Syncpen folders"

  • "Search for documents that mention authentication"

  • "Read my document titled 'API Design Notes'"

  • "What documents do I have in my 'Projects' folder?"

  • "Publish my 'Launch Post' document to Ghost as a draft"

  • "What's changed in my workspace since yesterday?"

Development

For contributing or running from source:

git clone https://github.com/airbuzz/syncpen-mcp.git
cd syncpen-mcp
npm install
npm run build     # or: npm run dev  (watch mode)

Point your MCP config at the built entry (node /path/to/syncpen-mcp/dist/index.js). It uses the production API by default; set SYNCPEN_API_URL only to target a local instance.

License

MIT

Available Tools

21 tools
syncpen_createB

Create a new SyncPen document.

Inputs: title, content, folderId.

syncpen_create_folderC

Create a new folder in your SyncPen account.

Inputs: name (required), parentId.

syncpen_delete_documentA

Delete a document (moved to trash). Only the document owner can delete it.

Inputs: documentId (required).

syncpen_delete_folderA

Delete a folder (moved to trash) along with its subfolders and the documents you own within them.

Inputs: folderId (required).

syncpen_list_commentsA

Read the comment threads on a document (top-level comments with their replies, line numbers, authors, and resolved state).

Inputs: documentId (required).

syncpen_list_connectionsA

List your connected CMS targets (WordPress, Ghost, Sanity) and their connectionIds. Use before syncpen_publish to find the connectionId when a target has more than one active connection.

Inputs: no named parameters.

syncpen_list_documentsB

List documents in your SyncPen account, optionally filtered by folder.

Inputs: limit, folderId.

syncpen_list_foldersA

List all folders in your SyncPen account.

Inputs: no named parameters.

syncpen_list_suggestionsA

List a document's suggestions so you can see what is still pending. Defaults to pending only; pass status 'all' to include accepted/rejected.

Inputs: documentId (required), status.

syncpen_move_documentA

Move a document into a folder, or to the root (un-foldered).

Inputs: documentId (required), folderId.

syncpen_move_folderA

Move a folder under a new parent folder, or to the root. Rejects circular moves and moves that exceed the nesting depth limit.

Inputs: folderId (required), parentId.

syncpen_publishA

Publish a SyncPen document to a connected CMS (WordPress, Ghost, or Sanity). Auto-selects the connection when only one is active for the target; otherwise pass connectionId.

Inputs: target (required), documentId (required), title, status, +2 more.

syncpen_readA

Read a SyncPen document's content as markdown. Use the document ID from search or list results.

Inputs: documentId (required).

syncpen_recent_changesA

A time-ordered feed of recent workspace changes — who created, edited, or trashed which documents, and when. Surfaces both in-app human edits and agent/API writes. Use it to catch up on what changed since you last looked (pass since), or to scope to one folder.

Inputs: limit, since, folderId.

syncpen_rename_folderB

Rename an existing SyncPen folder.

Inputs: name (required), folderId (required).

syncpen_reply_commentA

Reply to a comment thread. The reply is posted under the agent's name and notifies any @mentioned members.

Inputs: body (required), commentId (required).

syncpen_resolve_commentA

Mark a comment thread as resolved after acting on it.

Inputs: commentId (required).

syncpen_suggest_editA

Propose an edit to a document as a pending suggestion that a human accepts or rejects in the editor. The document is NOT changed until accepted. Use this instead of syncpen_update when you want human approval. Anchor the edit either by character offsets {from,to} or by a unique snippet {text} to replace.

Inputs: anchor (required), newText (required), documentId (required), note.

syncpen_updateB

Update an existing SyncPen document's title and/or content.

Inputs: documentId (required), title, content.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 21 tools

    Disambiguation5/5

    Each tool targets a distinct action on a specific resource (document, folder, comment, suggestion, etc.). Overlap is minimal and well-handled by descriptions, e.g., syncpen_update vs syncpen_suggest_edit are clearly separated by intent.

    Naming Consistency5/5

    All tools follow the pattern syncpen_verb_noun in snake_case, consistently using actions like create, delete, list, read, move, etc. This makes it easy for an agent to predict tool names.

    Tool Count4/5

    21 tools is slightly above the typical range but justified by the server's broad feature set covering documents, folders, comments, suggestions, publishing, search, and analytics. Each tool serves a clear purpose.

    Completeness4/5

    The tool surface covers the core document lifecycle (CRUD, search, folders, comments, suggestions, publishing). Minor gaps exist, such as no dedicated tool for retrieving document metadata separately from content, but overall it is well-rounded.

    Maintenance

    ActivityStale
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers