destreamed-mcp

MCP bridge for Destreamed — exposes your streams, beats, tasks and approvals to any MCP-aware agent.

Translates MCP stdio ↔ Destreamed's streamable-HTTP endpoint. Use this bridge when your MCP client only speaks stdio (e.g. Claude Desktop). Clients that speak streamable-HTTP natively (Claude Code, Cursor) skip the bridge entirely — point them directly at https://destreamed.com/api/v1/mcp.

Quick start

npx -y destreamed-mcp login

A browser tab opens. Sign in to Destreamed, approve the connection, and the CLI catches the callback on a local port. Tokens are saved to ~/.config/destreamed-mcp/tokens.json with 0600 permissions.

Then in your MCP client's config:

{
  "mcpServers": {
    "destreamed": {
      "command": "npx",
      "args": ["-y", "destreamed-mcp"]
    }
  }
}

No env vars, no pasted tokens. Restart your client and you're in.

Commands

destreamed-mcp           run the stdio bridge (used by your MCP client)
destreamed-mcp login     sign in via browser, save tokens
destreamed-mcp logout    clear stored tokens
destreamed-mcp status    show sign-in state

Config paths — Claude Desktop

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

Env vars (optional)

| Var | Default | Notes | |---|---|---| | DESTREAMED_URL | https://destreamed.com/api/v1 | API base. Point at your local dev backend with http://localhost:3001/api/v1. | | DESTREAMED_APP_URL | derived from DESTREAMED_URL | Web app base for the OAuth flow. Usually just https://destreamed.com. | | DESTREAMED_TOKEN | — | Bypass OAuth entirely. Useful for one-off scripts and CI. |

What you get

Four MCP tools with 14 actions between them:

• beat — drop / echo / complete
• stream — list / tuned / create / memos / categories / tune_in / pulse
• tasks — your open tasks plus the memos of their streams
• search — semantic search over everything you can see

Plus live notifications for new beats, echoes, and approvals.

Native HTTP clients

If you use Claude Code or Cursor, drop the bridge and point your client at the streamable-HTTP endpoint directly:

{
  "mcpServers": {
    "destreamed": {
      "type": "streamable-http",
      "url": "https://destreamed.com/api/v1/mcp",
      "headers": { "Authorization": "Bearer ds_..." }
    }
  }
}

Generate the ds_... token in Destreamed → Profile → Integrations → Add Integration.

Troubleshooting

• not signed in. Run ... — the CLI can't find stored tokens. Run destreamed-mcp login once.
• Login opens the wrong URL — set DESTREAMED_APP_URL to your actual web app (e.g. http://localhost:5173 in dev).
• Login browser tab never returns — corporate proxy or firewall blocking localhost callbacks. Try a different network or set DESTREAMED_TOKEN to a token minted from Profile → Integrations.
• 401 on every call — token was revoked in the app (Profile → Integrations). Run destreamed-mcp login again.

License

MIT © ccInsights GbR