# Syncpen MCP Server Connect Claude Code (or any MCP client) to your [Syncpen](https://www.syncpen.io) 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](https://www.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](https://www.syncpen.io/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 | 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: ```bash 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