Synapse CLI

OAuth login and MCP stdio server for connecting AI tools to Synapse.

Install

npm install -g @synapsecli/cli

Or from source:

git clone <repo-url>
cd synapse-cli
npm install
npm run build
npm link

Usage

# Log in via OAuth (opens browser)
synapse login

# Name this machine's OAuth client (shown in Connected Apps)
synapse login --as laptop
synapse login --client-name "Work Mac"

# Start MCP stdio server (for AI tool integration).
# The writing agent is taken from the MCP handshake automatically
# (clientInfo.name / clientInfo.version → X-Synapse-Agent header).
synapse mcp

# Remove stored credentials
synapse logout

Environment

• SYNAPSE_BASE_URL — Override API base URL (default: https://app.getsynapse.link)
• SYNAPSE_CLIENT_NAME — Default OAuth client name for synapse login (same as --as; identifies the machine, not the writing agent)

Credentials are stored in ~/.synapse/config.json (mode 600).

Integrations

• Claude Code
• Cursor
• OpenClaw
• Hermes