Skip to content
MCP server

weave

Self-hosted work database that agents drive over MCP, in a single SQLite file

Runs locallyStatus and history
Pricing
Open source
Platforms
self-hosted, CLI, API
Runs
Locally
Version
0.4.149
Listing updated
3 days ago

About weave

weave is an open-source MCP server for databases. It runs locally on your machine and is started by your AI client.

Everything lives in one SQLite file per workspace, served by a single Node process. Spaces hold tables, rows link to each other through bidirectional relations, and each row can carry lookups, rollups, formulas, workflow states, automations and any number of markdown documents.

The MCP server is started with weave mcp --data <file.db> and mounts in stdio clients such as Claude Code, Codex CLI, Cursor and Gemini CLI. The README says it does everything the web UI does, on the same engine and data, and rows can be referenced as Task#12.

Two safety nets are exposed to agents: an undo that reverses edits, creates, deletes, links and comments, and document revision history that can be browsed and restored. A hosted copy exists at weave.grunion.ai for people who prefer not to self-host.

Install

Run in a terminal

claude mcp add weave -- docker run -i --rm ghcr.io/grunion-ai/weave:0.4.149

Add to claude_desktop_config.json

{
  "mcpServers": {
    "weave": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/grunion-ai/weave:0.4.149"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "weave": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/grunion-ai/weave:0.4.149"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "weave": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/grunion-ai/weave:0.4.149"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "weave": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/grunion-ai/weave:0.4.149"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "weave": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/grunion-ai/weave:0.4.149"
      ]
    }
  }
}

Tools this server provides (3)

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

weave_undo
Reverses a change to a row: edits, creates, deletes, links or comments.
weave_doc_revisions
Lists the saved revisions of a document field.
weave_doc_restore
Restores a document field to an earlier revision.

What it does

One SQLite file
Each workspace is a single file; storage uses Node's built-in node:sqlite with no third-party runtime dependencies.
Connected tables
Relations, lookups, rollups, formulas, kanban boards and forms sit on the same rows.
Documents on every row
Rows carry markdown documents that are also reachable as .md, .html or .pdf URLs.
Undo for agent edits
weave_undo reverses edits, creates, deletes, links and comments.
Document revisions
Revisions can be listed and restored through weave_doc_revisions and weave_doc_restore.
Same data for people and agents
The web UI, REST API, CLI and MCP server all work on one data file.

Good for

  • Give a coding agent a structured place to track tasks and records
  • Replace a hosted Airtable or Notion database with a file you own
  • Let an agent draft and revise markdown documents attached to rows
  • Run a small team workspace on a laptop or a VPS with no per-seat bill

Pricing

Open source

MIT licensed and self-hosted; a hosted weave cloud exists, prices not published

Prices change. Check weave.grunion.ai before you buy.

weave FAQ

What do I need to run weave?

Node 22.16 or newer (24 LTS recommended); you clone the repo and run it, or use docker compose.

How do I connect Claude Code?

Run claude mcp add weave -- node /path/to/weave/bin/weave.js mcp --data /path/to/workspace.db.

Can an agent undo a bad change?

Yes, the weave_undo tool reverses edits, creates, deletes, links and comments.

Is there a hosted version?

Yes, the same code runs at weave.grunion.ai behind a sign-in, and self-hosted installs can back up to it.

Is weave free?

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

How do I add weave to Claude Code?

Run this command in your terminal: claude mcp add weave -- docker run -i --rm ghcr.io/grunion-ai/weave:0.4.149

What are the best alternatives to weave?

The closest alternatives to weave are Ha MCP, Concord MCP, Midplane, note1 and CalderFlow.

Alternatives to weave

  1. 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
  2. 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
  3. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  4. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  6. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication