Waggle MCP server

<!-- mcp-name: io.github.Abhigyan-Shekhar/Waggle-mcp -->

Project memory for humans and AI agents. Keep decisions, context, and the reasons behind them across conversations.

Install Waggle · Try the browser workspace · Documentation

Keep the context, not just the conversation

Waggle is an open-source, local-first memory layer for AI agents. It stores project knowledge as a graph: what you decided, why it matters, what it depends on, and what has changed. Your next conversation can pick up from that context instead of starting over.

Use Waggle with your MCP client, inspect and edit memory in Graph Studio, or bring a portable memory graph into the browser workspace.

and open questions without repeatedly pasting context.

• Continue across sessions. Recall project decisions, requirements, preferences,

contradictions, and the history behind a decision.

• Understand the reasoning. Explore relationships, supporting evidence,

humans approve the exact content before it becomes authoritative.

• Keep control of corrections. In the WebMCP workspace, agents propose changes;

workflows without tying your graph to one client.

• Take memory with you. Export and import .abhi files across supported

does not require a Waggle account or an external database.

• Start locally. The default SQLite store lives on your machine. Local use

Quick Start

The Python package requires Python 3.11+ and pipx. On macOS, you can install pipx with brew install pipx; see the installation guide for client-specific options.

pipx install waggle-mcp
pipx ensurepath

Restart your terminal after the first pipx ensurepath, then run:

waggle-mcp setup --yes
waggle-mcp doctor

Restart your MCP client to load Waggle. Setup detects supported clients and writes their configuration; automatic memory behavior uses the client's installed hooks, skills, or project instructions.

To check continuity, ask your agent to remember a project decision, then open a fresh session in the same project and ask what was decided. Keep the same project identifier across sessions.

Choose your client

For clients that accept an mcpServers configuration:

{
  "mcpServers": {
    "waggle": {
      "command": "waggle-mcp",
      "args": ["serve", "--transport", "stdio"]
    }
  }
}

If the command is not found, run pipx ensurepath and reopen your terminal. Use the troubleshooting guide for installation, startup, and client connection issues.

Shortened. The full README is on GitHub.