syncpen-mcp

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.

Quick Setup

1. Generate an API Key

• Go to Settings → API Keys in your Syncpen account
• Enable API Access
• Create a new API key
• 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