Guild
Shared context, memory, and task coordination across AI coding agents. Single Go binary, local SQLite, hybrid keyword and semantic search.
What is Guild?
Guild is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to shared context, memory, and task coordination across ai coding agents. single go binary, local sqlite, hybrid keyword and semantic search.
Shared context, memory, and task coordination across AI coding agents. Single Go binary, local SQLite, hybrid keyword and semantic search.
This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Shared context, memory, and task coordination across AI codi
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx guildConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Guild
Guild is a shared memory and task coordination system for AI coding agents, distributed as a single compiled Go binary backed by embedded SQLite that requires no external services or infrastructure. Multiple AI agents — Claude Code, Cursor, Codex, or any MCP-compatible client — can connect to the same Guild instance to share knowledge (lore), claim tasks without collisions, and hand off work with structured session briefs. Developers use it to coordinate parallel agent workflows, preserve institutional knowledge across sessions, and enable agents to collaborate on large codebases without stepping on each other.
Prerequisites
- A supported operating system: macOS, Linux, or Windows
- No API keys required — Guild is fully local
- At least one MCP-compatible client: Claude Code, Cursor, or Codex
- Git (optional, for installing from source)
Install the Guild binary
Install Guild using the official install script on macOS/Linux, or via Homebrew. Windows is supported with keyword-only search (no semantic embeddings).
# macOS/Linux:
curl -fsSL https://github.com/mathomhaus/guild/releases/latest/download/install.sh | sh
# Homebrew:
brew install mathomhaus/tap/guild
# Verify:
guild --versionInitialize Guild for your project
Run guild init inside your project directory. It detects installed MCP clients (Claude Code, Cursor, etc.) and configures them automatically to connect to the Guild server.
cd ~/projects/myapp
guild initRestart your MCP clients
After guild init completes, restart any MCP clients that were configured. They will connect to the local Guild SQLite store at ~/.guild/ and have access to all Guild tools.
Start a Guild session from your AI agent
At the beginning of a coding session, ask the AI agent to start a guild session. This loads the project oath, the most recent parting scroll (handoff notes), and the highest-priority quest.
Record knowledge and complete quests
Agents can inscribe lore (persistent knowledge), appraise (search) existing knowledge, accept quests atomically, and leave a brief at session end. Completed quests automatically unblock their dependencies.
guild lore inscribe "token refresh window" --kind observation \
--summary "tokens expire at 1h; refresh by 55m to avoid race"Guild Examples
Client configuration
After running guild init, the config is set automatically. This is the manual form for Claude Code's MCP config.
{
"mcpServers": {
"guild": {
"command": "guild",
"args": ["serve"]
}
}
}Prompts to try
Sample prompts for coordinating multi-agent workflows with Guild.
- "Start a guild session for this project and show me the current quests"
- "Search guild lore for anything related to token refresh handling"
- "Accept the highest-priority quest and begin working on it"
- "Record in guild lore that the cache invalidation logic lives in src/cache.ts"
- "Write a parting scroll summarizing what was accomplished this session"Troubleshooting Guild
guild command not found after installation
The install script places the binary in ~/.local/bin or /usr/local/bin. Ensure that directory is on your PATH: export PATH="$HOME/.local/bin:$PATH". Add this to your ~/.zshrc or ~/.bashrc to make it permanent.
Semantic search returns no results on Windows
Windows installations use keyword-only (BM25) retrieval because the ONNX embedding runtime is not supported on Windows. This is a known limitation. Use macOS or Linux for full hybrid keyword + semantic search.
Two agents claim the same quest simultaneously
Guild uses atomic SQLite locks to prevent this — the second claim will fail and the agent should call guild quest accept again to pick the next available quest. This behavior is by design to prevent collisions in parallel workflows.
Frequently Asked Questions about Guild
What is Guild?
Guild is a Model Context Protocol (MCP) server that shared context, memory, and task coordination across ai coding agents. single go binary, local sqlite, hybrid keyword and semantic search. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Guild?
Follow the installation instructions on the Guild GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Guild?
Guild works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Guild free to use?
Yes, Guild is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
Guild Alternatives — Similar Knowledge & Memory Servers
Looking for alternatives to Guild? Here are other popular knowledge & memory servers you can use with Claude, Cursor, and VS Code.
MemPalace
★ 52.6kA local AI memory system that stores all conversations verbatim and organizes them into navigable structures. It provides 19 MCP tools for AI assistants to search and retrieve past decisions, debugging sessions, and architecture debates automatically
Kratos
★ 25.7k🏛️ Memory System for AI Coding Tools - Never explain your codebase again. MCP server with perfect project isolation, 95.8% context accuracy, and the Four Pillars Framework.
Context Mode
★ 15.4kAn MCP server that preserves LLM context by intercepting large data outputs and returning only concise summaries or relevant sections. It enables efficient sandboxed code execution, file processing, and documentation indexing across multiple programm
Memu
★ 13.7kMemory for 24/7 proactive agents like OpenClaw.
MemOS
★ 9.3kMemOS (Memory Operating System) is a memory management operating system designed for AI applications. Its goal is: to enable your AI system to have long-term memory like a human, not only remembering what users have said but also actively invoking, u
Everos
★ 5.4kBuild, evaluate, and integrate long-term memory for self-evolving agents.
Browse More Knowledge & Memory MCP Servers
Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Guild in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Guild?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.