Sparks

Connect your agent

Works with any agent that speaks MCP or accepts a webhook: Grok Bot, Claude Code, Cursor, OpenClaw, n8n and others.

What each part does

  • MCP: your agent can read your projects and notes, create notes, add subtasks and mark things done. It never deletes anything.
  • Webhook: the Send to agent item in a note's ⋯ menu wakes your agent right away with that note.

Easiest: paste this into your agent

Connect yourself to my Sparks notebook.

1. Add the Sparks MCP server: https://sparks.6x7.gr/api/mcp (Streamable HTTP).
   - If your MCP client supports OAuth, add it by URL only; I'll approve the Sparks sign-in page that opens.
   - Otherwise use the connect link: POST https://sparks.6x7.gr/api/agent/connect/start with {"name": "<your name>"}. Show me the approve_url and code, keep poll_token private, then POST {"poll_token": "..."} to https://sparks.6x7.gr/api/agent/connect/poll every 5 seconds until status is "approved". Store the returned token as a secret and send it as "Authorization: Bearer <token>".
   - Check it works by calling list_projects.
2. Optional: if you can receive webhooks, create one that starts a run on POST and register it with the MCP tool set_agent_webhook, so "Send to agent" in Sparks wakes you.
3. Call get_agent_connection_status and tell me when you're done.

Full instructions: https://github.com/philipposk/sparks/blob/main/docs/agent-skill/connect-to-sparks/SKILL.md

Connect by URL (no token to copy)

Add https://sparks.6x7.gr/api/mcp to your agent. The first time it connects, a Sparks page opens: check the name and tap Allow. Disconnect anytime in Settings → Agent.

Claude Code

claude mcp add --transport http sparks https://sparks.6x7.gr/api/mcp
# then in Claude Code: /mcp → sparks → Authenticate

Cursor (~/.cursor/mcp.json)

{ "mcpServers": { "sparks": { "url": "https://sparks.6x7.gr/api/mcp" } } }

Codex (~/.codex/config.toml)

[mcp_servers.sparks]
url = "https://sparks.6x7.gr/api/mcp"
# then: codex mcp login sparks

OpenClaw, Grok Bot and other agents

Tell it: “Connect to Sparks at https://sparks.6x7.gr”. Agents without OAuth use its setup skill (connect-to-sparks): they show you a connect link, you tap Approve, and they get their own key.

Send to agent

After connecting, a capable agent registers its own webhook (tool set_agent_webhook). Otherwise paste your agent's webhook URL and key into Settings → Agent. Test it: open a note → ⋯ → Send to agent.

Fallback: token by hand

For agents that support neither: create a token in Settings → Agent and add it as a header.

{ "mcpServers": { "sparks": { "url": "https://sparks.6x7.gr/api/mcp", "headers": { "Authorization": "Bearer spk_mcp_…" } } } }

Technical details: docs/MCP.md

Support

Problems connecting? Write to help@6x7.gr. See also our Privacy and Terms.