🔌 weave-link

WeaveLink — The MCP Server that connects OpenWeave to any compatible AI client.

Part of the OpenWeave monorepo.

What it does

WeaveLink implements the Model Context Protocol (MCP) to expose OpenWeave's memory and planning tools to any compatible client:

• Claude Desktop — native MCP support
• Cursor — via MCP config
• Cline — via MCP config
• Any MCP-compatible client

Available MCP Tools

| Tool | Description | |---|---| | save_graph_node | Persist a memory node (concept, decision, error) to the session graph | | query_graph | Retrieve nodes relevant to a query from long-term memory | | suppress_node | Mark a node as erroneous and record its correction | | update_roadmap | Write the current milestone plan to roadmap.md | | get_session_context | Load full session state: graph summary + roadmap + error patterns |

Quick Setup

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "openweave": {
      "command": "npx",
      "args": ["-y", "@openweave/weave-link"],
      "env": {
        "OPENWEAVE_STORAGE": "/path/to/your/sessions"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "openweave": {
      "command": "npx",
      "args": ["-y", "@openweave/weave-link"],
      "env": {
        "OPENWEAVE_STORAGE": "./.openweave"
      }
    }
  }
}

Cline (VS Code)

In Cline settings → MCP Servers → Add:

{
  "name": "openweave",
  "command": "npx -y @openweave/weave-link",
  "env": { "OPENWEAVE_STORAGE": "./.openweave" }
}

Environment Variables

| Variable | Default | Description | |---|---|---| | OPENWEAVE_STORAGE | ./openweave-sessions | Root directory for session persistence | | OPENWEAVE_LOG_LEVEL | info | Log verbosity: debug, info, warn, error |

Docker

docker run -v $(pwd)/sessions:/sessions \
  -e OPENWEAVE_STORAGE=/sessions \
  ghcr.io/openweave/weave-link:latest

Installation

# Use directly via npx (no install needed)
npx @openweave/weave-link

# Or install globally
npm install -g @openweave/weave-link
weave-link start