Skip to content
MCP server

Sparks

Read and organise your Sparks idea notebook from an AI agent, with no delete tool

Install
Pricing
Open source
Platforms
API, Web
Runs
Remotely
Version
1.0.0
Listing updated
3 days ago

About Sparks

Sparks is an open-source MCP server for productivity. It runs as a hosted remote server, so there is nothing to install locally.

Notes, projects and subtasks in the Sparks notebook become reachable to an agent through this remote server. Subtasks nest up to four levels, and notes can be filed under projects, tagged, pinned, given due dates and marked done. The README stresses there is deliberately no delete tool.

Sign-in uses OAuth 2.1 with PKCE and dynamic client registration: add the URL, approve once on a Sparks page, and revoke later under Settings, Agent. Agents without OAuth, such as DeepSeek Harness, Grok Bot or OpenClaw, can use a one-tap connect link or a hand-made token sent as a bearer header.

A separate Send to agent action in a note's menu wakes an agent through a webhook. The agent can register its own with set_agent_webhook and pass accepts_intent to opt in to Plan, Build and Research sends. Local agents that cannot receive webhooks can claim sends from a poll inbox.

Install

Run in a terminal

claude mcp add --transport http sparks https://sparks.6x7.gr/api/mcp

Add to Settings → Connectors → Add custom connector

https://sparks.6x7.gr/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "sparks": {
      "url": "https://sparks.6x7.gr/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "sparks": {
      "type": "http",
      "url": "https://sparks.6x7.gr/api/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (10)

Taken from the project documentation; the running server may differ.

list_projects
Your projects with note counts.
list_notes
Search and filter notes.
get_note
One note with projects and its subtask tree.
create_note
Create a note in the Inbox or a project.
update_note
Change title, body, tags, done, pinned, due date or project.
add_subtask
Add a subtask up to four levels deep.
mark_done
Mark a note or subtask done or not done.
add_note_to_project
File a note under another project too.
get_agent_connection_status
Whether a Send to agent webhook is set.
set_agent_webhook
Register the webhook Sparks calls on Send to agent.

What it does

Notes and projects
List projects with note counts, search notes and read one with its subtask tree.
Create and update
Create notes in the Inbox or a project and edit title, body, tags, due date and pin state.
Nested subtasks
Add subtasks up to four levels deep and mark them done.
No deletion
The server has no delete tool, so an agent cannot remove notes.
Send to agent
A note menu action wakes a connected agent by webhook or poll inbox.
OAuth connect
Add by URL and approve once; revoke any time in Settings.

Good for

  • Capture an idea from a chat into the Inbox
  • Break a project note into subtasks
  • Ask an agent what is due this week
  • Hand a note to an agent to plan or research it

Pricing

Open source

MIT-licensed connector; Sparks plans not published

Prices change. Check sparks.6x7.gr before you buy.

Sparks FAQ

Can an agent delete my notes?

No. The server deliberately has no delete tool.

How do I connect Claude Code?

Run claude mcp add --transport http sparks https://sparks.6x7.gr/api/mcp, then use /mcp and Authenticate.

What if my agent does not support OAuth?

Use the connect link flow, or create a token in Settings, Agent and send it as an Authorization bearer header.

What licence is the connector under?

The sparks-mcp repository is MIT licensed.

Is Sparks free?

Yes. Sparks is open source, so you can use and self-host it for free.

How do I add Sparks to Claude Code?

Run this command in your terminal: claude mcp add --transport http sparks https://sparks.6x7.gr/api/mcp

What are the best alternatives to Sparks?

The closest alternatives to Sparks are Codebase Memory, XERJ, Ha MCP, Claude Code Ultimate Guide and Nautilus Compass Memory.

Alternatives to Sparks

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  4. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  5. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  6. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools