{ "markdown": "

\n \n \n \n \"Syncpen\"\n \n \n

\n\n# Syncpen MCP Server\n\nConnect 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.\n\n**Don't have an account yet?** Create one free at **[syncpen.io](https://www.syncpen.io)**.\n\n## What is Syncpen great at?\n\n- **Build a knowledge base your AI maintains** — capture notes, docs, and clips, then let your agent organize, cross-link, and keep it current.\n- **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.\n- **Your agents and you on one project** — everyone works in the same live documents; every edit is shared, legible, and attributed.\n- **Edits with a paper trail** — agents propose changes as signed suggestions you accept or reject. Nothing changes silently.\n- **Research → draft → ship without leaving your tools** — clip sources, let your AI draft from them, publish.\n\n## Quick Setup\n\n### 1. Generate an API Key\n\n1. Go to **[Settings → API Keys](https://www.syncpen.io/settings/api-keys)** in your Syncpen account\n2. Enable API Access\n3. Create a new API key\n4. Copy the key (you'll only see it once!)\n\n### 2. Configure Claude Code\n\nAdd to your MCP configuration file (`~/.mcp.json` or project-level `.mcp.json`):\n\n```json\n{\n \"mcpServers\": {\n \"syncpen\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"syncpen-mcp\"],\n \"env\": {\n \"SYNCPEN_API_KEY\": \"sp_your_api_key_here\"\n }\n }\n }\n}\n```\n\nThat's it! Claude Code will automatically download and run the MCP server.\n\n## Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `syncpen_search` | Search documents by title and body content (full text) |\n| `syncpen_read` | Read a document's content as markdown |\n| `syncpen_list_folders` | List all folders |\n| `syncpen_list_documents` | List documents, optionally by folder |\n| `syncpen_create` | Create a new document — personal by default, or in a team space via `teamId` |\n| `syncpen_update` | Update a document's title and/or content |\n| `syncpen_suggest_edit` | Propose an edit as a pending suggestion a human accepts/rejects (doc unchanged until accepted) |\n| `syncpen_list_suggestions` | List a document's pending (or all) suggestions |\n| `syncpen_list_comments` | Read comment threads (with replies, line numbers, authors) |\n| `syncpen_reply_comment` | Reply to a comment thread (signed, notifies @mentions) |\n| `syncpen_resolve_comment` | Mark a comment thread resolved |\n| `syncpen_move_document` | Move a document into a folder, or to the root |\n| `syncpen_delete_document` | Delete a document (moved to trash) |\n| `syncpen_create_folder` | Create a folder (optionally nested) |\n| `syncpen_rename_folder` | Rename a folder |\n| `syncpen_move_folder` | Move a folder under a new parent, or to the root |\n| `syncpen_delete_folder` | Delete a folder and its contents (moved to trash) |\n| `syncpen_publish` | Publish a document to WordPress, Ghost, or Sanity |\n| `syncpen_list_connections` | List connected CMS targets and their connectionIds — personal by default, or scoped to a team via `teamId`/`documentId` |\n| `syncpen_list_teams` | List your team spaces (id, name, role, member count) |\n| `syncpen_recent_changes` | A time-ordered feed of who created/edited/trashed which documents, and when |\n| `syncpen_related` | Given a document, suggest what else to read — blends co-access (docs worked on together) with the /editor links |\n| `syncpen_drive_list_files` | List/search files in the user's connected Google Drive |\n| `syncpen_drive_read_file` | Read a Drive file's content (Google Docs and plain text files only) |\n| `syncpen_news_search` | Search recent world news via the user's connected World News API key |\n| `syncpen_slack_list_channels` | List public channels in the user's connected Slack workspace |\n| `syncpen_slack_read_channel` | Read a public Slack channel's recent message history |\n| `syncpen_notion_search` | Search pages in the user's connected Notion workspace |\n| `syncpen_notion_read_page` | Read a Notion page's top-level content |\n\n## Usage Examples\n\nOnce configured, ask Claude Code:\n\n- \"List my Syncpen folders\"\n- \"Search for documents that mention authentication\"\n- \"Read my document titled 'API Design Notes'\"\n- \"What documents do I have in my 'Projects' folder?\"\n- \"Publish my 'Launch Post' document to Ghost as a draft\"\n- \"What's changed in my workspace since yesterday?\"\n\n## Development\n\nFor contributing or running from source:\n\n```bash\ngit clone https://github.com/airbuzz/syncpen-mcp.git\ncd syncpen-mcp\nnpm install\nnpm run build # or: npm run dev (watch mode)\n```\n\nPoint 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.\n\n## License\n\nMIT\n", "bytes": 5331, "sha": "a6a50e59dc17cebd5b425c8faeb15411bfee67165e017772e06803032f9d3346", "repo_slug": "airbuzz/syncpen-mcp", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_io_github_airbuzz_syncpen_mcp_9de195df/readme" }