Capture from Claude Desktop.

1. Open Settings → Integrations → MCP tokens in Pulse.
2. Click Generate new token.
3. Label it (e.g. “Claude Desktop, work Macbook”), pick an expiration.
4. Copy the token. Pulse shows it exactly once. If you close the modal before copying, generate a fresh one.

Find your config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Add the pulse entry to mcpServers:

{
  "mcpServers": {
    "pulse": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://pulsehq.tech/api/mcp",
        "--header", "Authorization: Bearer pulse_mcp_PASTE_YOUR_TOKEN_HERE"
      ]
    }
  }
}

Replace the placeholder with the token you copied. Save and restart Claude Desktop. Claude Desktop launches stdio servers from this file, so the hosted endpoint rides through the mcp-remote bridge (needs Node.js installed; no global install, npx fetches it).

Look for the MCP indicator in Claude Desktop. pulse lists all 25 tools, but a pulse_mcp_ token can call only the ten write tools (the 7 capture tools, the personal-memory pair pulse_remember / pulse_forget, and pulse_propose_action, which only drafts into the approval inbox) plus pulse_recallfor your own memory. A quick sanity check: say “Save a note to Pulse: MCP capture is wired up.” Claude calls pulse_capture_note and responds with a confirmation. (Read tools like list_recent_decisions need a pk_live_ workspace key with the read scope, not this capture token.)

Have a conversation in Claude about anything worth keeping. Then say:

Save this conversation to Pulse, tag it pricing-strategy.

Claude calls pulse_capture_conversation and responds with a confirmation URL like /app/captured/clz.... Open it to see the captured conversation and any extracted decisions or commitments.

For just a piece: “Save the Postgres vs MongoDB tradeoff to Pulse, language: markdown.” For a decision: “We’ve decided to use Postgres because of pgvector. Alternatives were MongoDB and DynamoDB. Save the decision.”

• “Pulse server failed to load”, your JSON has a syntax error or the URL is wrong.
• 401 unauthorized, the token is wrong, expired, or revoked. Regenerate at Settings → Integrations.
• “This API key isn’t allowed to capture”, the capture call came back as an error result (not a 403). Capture needs either a pulse_mcp_ token or a pk_live_ workspace key with the write scope. A key with neither is rejected.
• Capture tools not appearing, restart Claude Desktop. Tool lists load at startup.