Allows an AI agent to search, read, draft, suggest edits, and publish documents within a Syncpen markdown workspace.
Also known as airbuzz/syncpen-mcp, syncpen-mcp
- Stars
- 0
- Tools
- 29
- Downloads, 30 days
- —
- Latest version
- 1.6.3
- Last commit
- Aug 24, 2026
- License
- MIT
What is Syncpen MCP?
Syncpen allows an AI agent to search, read, draft, suggest edits, and publish documents within a Syncpen markdown workspace. It exposes 29 tools, such as syncpen_search, syncpen_read, syncpen_list_folders.
Summary generated from the project's README
About Syncpen MCP server
Syncpen provides a bridge between AI agents and a markdown-based writing workspace. This server allows clients like Claude Code to interact directly with your documents, enabling an agent to manage a knowledge base by searching, reading, and organizing notes. It is designed for writers and teams who want an AI to participate in the same live documents that humans use, ensuring all edits are visible and attributed.
Users set up the server by providing a Syncpen API key in their MCP configuration. The toolset includes specific commands for document management, such as syncpen_create, syncpen_update, and syncpen_move_document. A unique feature is the ability to propose changes through syncpen_suggest_edit, which creates a pending suggestion that a human must manually accept or reject rather than changing the text silently.
Beyond simple writing, the server supports publishing workflows. Through the syncpen_publish tool, agents can ship completed drafts directly to CMS platforms like WordPress, Ghost, or Sanity. It also integrates with external data sources like Google Drive, Notion, and Slack to help agents gather context for their writing tasks.
What you can do with it
- 1Propose document revisionsAsk the AI to suggest improvements to a text without overwriting the original content immediately.
- 2Publish content to a CMSInstruct your agent to send a finished markdown document to a blogging platform.
- 3Maintain a knowledge baseHave an agent organize and cross-link your various notes and clips.
Written from the project's README. Every use case is checked against a quote from it.
How to install Syncpen MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Syncpen MCP in Claude Code
$ claude mcp add --env 'SYNCPEN_API_KEY=<YOUR_SYNCPEN_API_KEY>' syncpen-mcp -- npx -y syncpen-mcpInstall Syncpen MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"syncpen-mcp": {
"command": "npx",
"args": [
"-y",
"syncpen-mcp"
],
"env": {
"SYNCPEN_API_KEY": "<YOUR_SYNCPEN_API_KEY>"
}
}
}
}Install Syncpen MCP in VS Code
.vscode/mcp.json
{
"servers": {
"syncpen-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"syncpen-mcp"
],
"env": {
"SYNCPEN_API_KEY": "<YOUR_SYNCPEN_API_KEY>"
}
}
}
}Install Syncpen MCP in VS Code CLI
$ code --add-mcp '{"name":"syncpen-mcp","type":"stdio","command":"npx","args":["-y","syncpen-mcp"],"env":{"SYNCPEN_API_KEY":"<YOUR_SYNCPEN_API_KEY>"}}'Install Syncpen MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"syncpen-mcp": {
"command": "npx",
"args": [
"-y",
"syncpen-mcp"
],
"env": {
"SYNCPEN_API_KEY": "<YOUR_SYNCPEN_API_KEY>"
}
}
}
}Install Syncpen MCP in Codex
$ codex mcp add syncpen-mcp --env 'SYNCPEN_API_KEY=<YOUR_SYNCPEN_API_KEY>' -- npx -y syncpen-mcpInstall Syncpen MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.syncpen-mcp] command = "npx" args = ["-y", "syncpen-mcp"] [mcp_servers.syncpen-mcp.env] SYNCPEN_API_KEY = "<YOUR_SYNCPEN_API_KEY>"
Install Syncpen MCP in Gemini CLI
$ gemini mcp add -s user -e 'SYNCPEN_API_KEY=<YOUR_SYNCPEN_API_KEY>' syncpen-mcp npx -- -y syncpen-mcpInstall Syncpen MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"syncpen-mcp": {
"command": "npx",
"args": [
"-y",
"syncpen-mcp"
],
"env": {
"SYNCPEN_API_KEY": "<YOUR_SYNCPEN_API_KEY>"
}
}
}
}Syncpen MCP tools 29
Detected from the READMEsyncpen_searchsyncpen_readsyncpen_list_folderssyncpen_list_documentssyncpen_createsyncpen_updatesyncpen_suggest_editsyncpen_list_suggestionssyncpen_list_commentssyncpen_reply_commentsyncpen_resolve_commentsyncpen_move_document
| syncpen_search | — | |
| syncpen_read | — | |
| syncpen_list_folders | — | |
| syncpen_list_documents | — | |
| syncpen_create | — | |
| syncpen_update | — | |
| syncpen_suggest_edit | — | |
| syncpen_list_suggestions | — | |
| syncpen_list_comments | — | |
| syncpen_reply_comment | — | |
| syncpen_resolve_comment | — | |
| syncpen_move_document | — |
Show all 29 toolsShow fewer tools
syncpen_delete_documentsyncpen_create_foldersyncpen_rename_foldersyncpen_move_foldersyncpen_delete_foldersyncpen_publishsyncpen_list_connectionssyncpen_list_teamssyncpen_recent_changessyncpen_relatedsyncpen_drive_list_filessyncpen_drive_read_filesyncpen_news_searchsyncpen_slack_list_channelssyncpen_slack_read_channelsyncpen_notion_searchsyncpen_notion_read_page
| syncpen_delete_document | — | |
| syncpen_create_folder | — | |
| syncpen_rename_folder | — | |
| syncpen_move_folder | — | |
| syncpen_delete_folder | — | |
| syncpen_publish | — | |
| syncpen_list_connections | — | |
| syncpen_list_teams | — | |
| syncpen_recent_changes | — | |
| syncpen_related | — | |
| syncpen_drive_list_files | — | |
| syncpen_drive_read_file | — | |
| syncpen_news_search | — | |
| syncpen_slack_list_channels | — | |
| syncpen_slack_read_channel | — | |
| syncpen_notion_search | — | |
| syncpen_notion_read_page | — |
Configuration
SYNCPEN_API_KEYRequiredSecretYour Syncpen API key (starts with sp_). Create one at https://www.syncpen.io/settings/api-keys.
| Name | Description | |
|---|---|---|
| SYNCPEN_API_KEY | Your Syncpen API key (starts with sp_). Create one at https://www.syncpen.io/settings/api-keys. | RequiredSecret |
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachableairbuzz/syncpen-mcp is public and reachablegithub.com/airbuzz/syncpen-mcp ↗Pass
- Package names this repository as its sourcesyncpen-mcp names airbuzz/syncpen-mcp as sourcenpmjs.com/package/syncpen-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-08-24github.com/airbuzz/syncpen-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from syncpen-mcpPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model29 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubSyncpen 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
Syncpen MCP questions
How do I add Syncpen MCP to Claude Code?
Run claude mcp add --env 'SYNCPEN_API_KEY=<YOUR_SYNCPEN_API_KEY>' syncpen-mcp -- npx -y syncpen-mcp in your terminal. Add --scope user to make it available in every project.
How do I add Syncpen MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Syncpen MCP provide?
It exposes 29 tools, including syncpen_search, syncpen_read, syncpen_list_folders, syncpen_list_documents, syncpen_create.
Can the AI make direct changes to my documents?
No, agents propose changes as signed suggestions that a human must explicitly accept or reject to ensure nothing changes silently.
Where can I publish documents from Syncpen?
You can publish documents directly to WordPress, Ghost, or Sanity.