agent-knowledge — Claude Code MCP server: memory, setup
agent-knowledge carries project knowledge across sessions and searches earlier agent transcripts. It fits workflows where decisions and context must persist.
claude mcp add agent-knowledge -- npx -y agent-knowledgeWhat agent-knowledge does
agent-knowledge keeps a Markdown knowledge base that can be synced with Git. An agent can retrieve project context, decisions, workflows, errors, and configuration from later sessions. It also indexes transcripts from Claude Code, Cursor, Codex CLI, Aider, Continue.dev, Cline, and OpenCode.
Search combines semantic similarity with TF-IDF ranking. The knowledge graph can connect entries to code structure and validity periods. knowledge(action: "wakeup") builds a sectioned context bundle within a token budget, with 800 as the default. The server can flag stale entries and promote session findings into a dated .dreams/YYYY-MM-DD.md diary.
Node >= 20 is required to run it. The MCP connection uses npx; embedding options include local Hugging Face, OpenAI, Claude/Voyage, and Gemini providers.
What it helps with
- carry project decisions into later sessions
- search earlier agent transcripts
- build a focused startup context
- spot entries affected by code changes
- connect knowledge entries to code relationships
Example prompts for the agent
- Save the API structure decision to the project knowledge base.
- Use
knowledge(action: "wakeup")to prepare context for this session. - Search the transcripts for the earlier database connection error.
How to install agent-knowledge
Platform CLI
claude mcp add agent-knowledge -- npx -y agent-knowledgePlatform CLI
codex mcp add agent-knowledge -- npx -y agent-knowledgeConfig file
{
"mcpServers": {
"agent-knowledge": {
"command": "npx",
"args": [
"-y",
"agent-knowledge"
]
}
}
}Config file
{
"servers": {
"agent-knowledge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"agent-knowledge"
]
}
}
}Platform CLI
gemini mcp add agent-knowledge npx -y agent-knowledgeStep 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 agent-knowledge
How do I install agent-knowledge in Claude Code?
Run claude mcp add agent-knowledge -- npx -y agent-knowledge. This adds the MCP server to Claude Code.
What does agent-knowledge do?
It preserves project knowledge across sessions and searches transcripts from several AI coding tools. Its knowledge base can sync through Git, while retrieval blends semantic similarity with TF-IDF ranking.
What is required to run agent-knowledge?
Node >= 20 is required. The server connects through npx, and embeddings can use local Hugging Face, OpenAI, Claude/Voyage, or Gemini providers.
