Syncpen

io.github.airbuzzPublished by GitHub account airbuzzv1.6.3Updated Oct 27, 2026

The markdown workspace your AI can read, search, and suggest edits in — every change signed.

Overview

AI-generated overview

Connects an AI assistant to a Syncpen markdown workspace so it can search, read, draft, suggest edits, comment, organize and publish documents.

What you can do
  • Search and read documents as markdown, and list folders and documents
  • Create and update documents, and propose edits as pending suggestions for a human to accept or reject
  • Read, reply to and resolve comment threads
  • Create, rename, move and delete folders and documents
  • Publish documents to WordPress, Ghost or Sanity, and list connected CMS targets
  • Review recent workspace changes, related documents and team spaces
When to use it
Useful when your writing or knowledge base lives in Syncpen and you want an assistant to draft, cross-link, comment on or publish it while keeping human approval over changes. Also handy for pulling in connected Drive, Notion, Slack and news sources during research.
Requirements
Runs locally over stdio, typically via npx with the syncpen-mcp package, so Node.js is needed. Requires a Syncpen account with API access enabled and an API key supplied in the SYNCPEN_API_KEY environment variable. Optional SYNCPEN_API_URL targets a non-production instance. Connected Drive, Notion, Slack, World News and CMS integrations must be set up in the Syncpen account.
Before you install
The API key in SYNCPEN_API_KEY grants access to your workspace and is shown only once, so store it carefully. Tools can create, update, move and delete documents and folders, reply to comments and publish to external CMS targets; deletions go to trash but publishing and replies are visible to others. Content from connected Google Drive, Notion, Slack and news services is sent through the Syncpen API.

Installation

In SourceWeft

  1. Open Syncpen in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

[Syncpen]

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

  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):

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

ToolDescription
syncpen_searchSearch documents by title and body content (full text)
syncpen_readRead a document's content as markdown
syncpen_list_foldersList all folders
syncpen_list_documentsList documents, optionally by folder
syncpen_createCreate a new document — personal by default, or in a team space via teamId
syncpen_updateUpdate a document's title and/or content
syncpen_suggest_editPropose an edit as a pending suggestion a human accepts/rejects (doc unchanged until accepted)
syncpen_list_suggestionsList a document's pending (or all) suggestions
syncpen_list_commentsRead comment threads (with replies, line numbers, authors)
syncpen_reply_commentReply to a comment thread (signed, notifies @mentions)
syncpen_resolve_commentMark a comment thread resolved
syncpen_move_documentMove a document into a folder, or to the root
syncpen_delete_documentDelete a document (moved to trash)
syncpen_create_folderCreate a folder (optionally nested)
syncpen_rename_folderRename a folder
syncpen_move_folderMove a folder under a new parent, or to the root
syncpen_delete_folderDelete a folder and its contents (moved to trash)
syncpen_publishPublish a document to WordPress, Ghost, or Sanity
syncpen_list_connectionsList connected CMS targets and their connectionIds — personal by default, or scoped to a team via teamId/documentId
syncpen_list_teamsList your team spaces (id, name, role, member count)
syncpen_recent_changesA time-ordered feed of who created/edited/trashed which documents, and when
syncpen_relatedGiven a document, suggest what else to read — blends co-access (docs worked on together) with the /editor links
syncpen_drive_list_filesList/search files in the user's connected Google Drive
syncpen_drive_read_fileRead a Drive file's content (Google Docs and plain text files only)
syncpen_news_searchSearch recent world news via the user's connected World News API key
syncpen_slack_list_channelsList public channels in the user's connected Slack workspace
syncpen_slack_read_channelRead a public Slack channel's recent message history
syncpen_notion_searchSearch pages in the user's connected Notion workspace
syncpen_notion_read_pageRead 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:

bash
git clone https://github.com/airbuzz/syncpen-mcp.gitcd syncpen-mcpnpm installnpm 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

Source: README.md at commit e7f4bf7

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.6.3LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts