# Sparks

> Sparks is an open-source MCP server for productivity. Read and organise your Sparks idea notebook from an AI agent, with no delete tool. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, Web
- **Website:** https://sparks.6x7.gr/help/connect-agent
- **Repository:** https://github.com/6x7gr/sparks-mcp
- **MCP Registry name:** gr.6x7/sparks
- **Categories:** productivity, knowledge and memory
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://sparks.6x7.gr/api/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.

---
Source: https://ai-powered.com/mcp/sparks
