weave — Claude Code MCP server: SQLite workspace database
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.
MIT ★ 19 updated 2026-10-23
claude mcp add weave -- docker run -i --rm ghcr.io/grunion-ai/weave:0.4.108What weave 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.
What it helps with
- 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 for the agent
- 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
How to install weave
Platform CLI
claude mcp add weave -- docker run -i --rm ghcr.io/grunion-ai/weave:0.4.108Platform CLI
codex mcp add weave -- docker run -i --rm ghcr.io/grunion-ai/weave:0.4.108Config file
{
"mcpServers": {
"weave": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/grunion-ai/weave:0.4.108"
]
}
}
}Config file
{
"servers": {
"weave": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/grunion-ai/weave:0.4.108"
]
}
}
}Platform CLI
gemini mcp add weave docker run -i --rm ghcr.io/grunion-ai/weave:0.4.108Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about weave
How do I install weave in Claude Code?
Run claude mcp add weave -- docker run -i --rm ghcr.io/grunion-ai/weave:0.4.108. Or install it as a plugin from the marketplace: /plugin install weave --marketplace grunion-ai/weave.
What does weave do?
Stores tables, relations, formulas, and markdown docs in one SQLite file. Agents manage that data over MCP, REST, or the CLI.
Which Node version is required?
Node 22.16 or newer. Node 24 LTS is recommended. No build step or npm install is needed.