# weave

weave is an MCP server for Claude Code that brings tables, relations, tasks, and markdown docs together in a local SQLite database. An agent manages the database over MCP.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 19 repo stars
- Author: grunion-ai
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/grunion-ai/weave
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/weave

## What it does

weave keeps structured work in a single SQLite file. Tables, rows, links between entities, formulas, workflow states, and markdown documents attached to each row all live there. The MCP server, REST API, and CLI expose the same engine over the same data file.

It runs on Node's built-in `node:sqlite`, with no third-party dependencies. Start it with `node bin/weave.js serve --port 4400 --data ./my-workspace.db`. Node 22.16 or newer is required.

Agents get seventeen tools by default, including `weave_build` and `weave_undo`. `weave mcp --tools all` exposes all sixty-five. Each row's documents have plain URLs: `/e/Task#12/doc.md`, `.html`, `.pdf`.

To wire it into Claude Code, run `claude mcp add weave -- docker run -i --rm ghcr.io/grunion-ai/weave:0.4.108` or use the plugin marketplace: `/plugin install weave --marketplace grunion-ai/weave`.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add weave -- docker run -i --rm ghcr.io/grunion-ai/weave:0.4.108
```

### Codex

**Platform CLI**
```bash
codex mcp add weave -- docker run -i --rm ghcr.io/grunion-ai/weave:0.4.108
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "weave": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/grunion-ai/weave:0.4.108"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "weave": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/grunion-ai/weave:0.4.108"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add weave docker run -i --rm ghcr.io/grunion-ai/weave:0.4.108
```

## When to use it
- replace a SaaS workspace with a local SQLite file
- let an agent read and update work data
- keep tables and per-row documents in one place
- undo entity changes with `weave undo`
- restore older revisions of markdown docs

## Example prompts
- Connect weave to Claude Code: `claude mcp add weave -- docker run -i --rm ghcr.io/grunion-ai/weave:0.4.108`
- Create a task table and link it to a projects table
- List rows with status in progress and show their documents

## Similar
- [Hatchdoor](https://affpapa.org/en/nevibecode/mcp/hatchdoor.md) — MCP server · ★ 77 repo stars
- [Notion](https://affpapa.org/en/nevibecode/mcp/notion.md) — MCP server · 3841 installs
- [Stuga](https://affpapa.org/en/nevibecode/mcp/stuga.md) — MCP server · ★ 6 repo stars
- [strata](https://affpapa.org/en/nevibecode/mcp/agenerationforwordz-tech-strata.md) — MCP server · ★ 6 repo stars
- [cabinet-ai-knowledge-base](https://affpapa.org/en/nevibecode/skills/cabinet-ai-knowledge-base.md) — skill · 615 installs
- [sqlite-graph-memory](https://affpapa.org/en/nevibecode/mcp/sqlite-graph-memory.md) — MCP server · ★ 17 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
