npm syncpen-mcpstdioMITupdated 15d ago
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.
What can you do with 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
- 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
Install
Add Syncpen to your client. Pick the one you use.
claude mcp add syncpen-mcp -- npx -y syncpen-mcpcodex mcp add syncpen-mcp -- npx -y syncpen-mcpamp mcp add syncpen-mcp -- npx -y syncpen-mcp{
"mcpServers": {
"syncpen-mcp": {
"command": "npx",
"args": [
"-y",
"syncpen-mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"syncpen-mcp": {
"command": "npx",
"args": [
"-y",
"syncpen-mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"syncpen-mcp","command":"npx","args":["-y","syncpen-mcp"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"syncpen-mcp": {
"command": "npx",
"args": [
"-y",
"syncpen-mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"syncpen-mcp": {
"command": "npx",
"args": [
"-y",
"syncpen-mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"syncpen-mcp": {
"command": "npx",
"args": [
"-y",
"syncpen-mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"syncpen-mcp": {
"type": "local",
"command": "npx",
"args": [
"-y",
"syncpen-mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"syncpen-mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"syncpen-mcp"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y syncpen-mcpRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
29 tools
Syncpen exposes 29 tools to a connected agent.
- 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
Score
77 / 100
Good
- Documentation25/25
- Maintenance19/25
- Trust13/20
- Capability8/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 8 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 29 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Version history
| Versions | Published |
|---|---|
| 1.6.3Latest | Jul 2, 2026 |