# weave

> weave is an open-source MCP server for databases. Self-hosted work database that agents drive over MCP, in a single SQLite file. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, CLI, API, Web
- **Website:** https://weave.grunion.ai
- **Repository:** https://github.com/grunion-ai/weave
- **MCP Registry name:** io.github.grunion-ai/weave
- **Categories:** databases, productivity
- **Listing updated:** 2026-11-14

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

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

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

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [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.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.

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