TL;DR
TL;DR: ContextForge is a free MCP server that gives Claude, Cursor, and Copilot persistent memory across sessions — so your AI coding assistant remembers your project context, decisions, and patterns without you re-explaining them every time.
Source and Accuracy Notes
⚠️ This section is MANDATORY. All links must be verified from actual source, not guessed.
- Project page: contextforge.dev — verified
- Source repository: not publicly hosted (MCP server distributed via npm)
- License: proprietary SaaS (free tier available)
- HN launch thread: Show HN: ContextForge – Persistent memory MCP server for Claude (launched 2025)
- Source last checked: 2026-08-20
What Is ContextForge?
Every time you start a new Claude Code session, open Cursor, or use Copilot, the conversation begins from scratch. ContextForge solves this by running a local MCP server that stores your project knowledge and surfaces it to any connected AI tool.
The core idea: instead of stuffing a CLAUDE.md that goes stale, you maintain a living knowledge base that persists across sessions and is automatically consulted by your AI tools.
Three Resource Types
ContextForge organizes memory into three types:
- Knowledge — notes, documentation, architectural decisions, code patterns. The stuff you want Claude to know without re-explaining.
- GitHub — commits and pull requests. Gives the AI access to your actual code history.
- Tasks — tracking items and tasks. Keeps task state persistent across sessions.
Key Features
- Spaces — personal knowledge bases within ContextForge. Group related knowledge together.
- Skills — reusable prompts that encode recurring workflows
- Routines — multi-step processes the AI can execute consistently
- Semantic Search — finds relevant knowledge using vector similarity
- Git Integration — connects to GitHub for commit and PR context
- Project Linking — links multiple AI tools to the same project context
- Session Presence — knows which tools are active in a project
Setup Workflow
Prerequisites
- Node.js 18 or higher
- One of: Claude Desktop, Claude Code, Cursor IDE, Windsurf, or ChatGPT
Step 1: Install ContextForge MCP
On macOS or Linux:
npm install -g contextforge-mcp
On Windows (PowerShell as Administrator):
npm install -g contextforge-mcp
Step 2: Run the Setup Wizard
npx contextforge-setup
The wizard guides you through account creation and MCP configuration.
Step 3: Connect to Claude Code
claude mcp add contextforge -s user -e CONTEXTFORGE_API_KEY=your_key -- npx -y contextforge-mcp
Step 4: Verify
claude mcp list
Or run:
npx contextforge-setup --verify
Installing for Specific IDEs
The docs include specific guides for:
- Cursor IDE — see contextforge.dev/docs/install-cursor
- Windsurf — see contextforge.dev/docs/install-windsurf
- ChatGPT — see contextforge.dev/docs/install-chatgpt
- Claude Desktop — standard MCP configuration
Deeper Analysis
Why “The Week Two Problem” Matters
ContextForge’s own blog frames this as “The Week Two Problem”: 60% of AI agent failures in week two are not the model’s fault — the AI has simply forgotten what it knew in week one. A longer conversation context window does not solve this; it just delays the inevitable reversion.
Persistent memory solves the architecture problem at the root: the context is externalized, not stuffed into a finite window.
How It Differs from CLAUDE.md
A CLAUDE.md file is a static document that:
- Requires manual updates
- Gets ignored when context window is saturated
- Is tool-specific (only Claude Code reads it)
ContextForge’s knowledge base is:
- Dynamically updated through the AI itself (“save this as knowledge”)
- Queried via semantic search, not context stuffing
- Tool-agnostic via the MCP protocol
The Free Tier
The product offers a free tier with a 3-minute setup. Pricing beyond that is not publicly listed — you’d need to sign up to see paid tier details.
Practical Evaluation Checklist
- [ ] Installs via
npm install -g contextforge-mcpwithout errors - [ ]
npx contextforge-setupwizard completes account flow - [ ]
claude mcp listshows contextforge as connected - [ ] Can save a knowledge note and have it recalled in a new session
- [ ] Cursor IDE integration works after setup
- [ ] Semantic search returns relevant results from saved knowledge
Security Notes
The contextforge.dev/docs/security page covers API key management and storage. For self-hosted or air-gapped environments, review the security documentation before using ContextForge with proprietary code.
FAQ
Q: Does this work with GitHub Copilot in VS Code? A: ContextForge targets Claude Code, Cursor, and Copilot via MCP. VS Code Copilot does not natively support the MCP protocol — you would need the Copilot Chat interface in IDEs that expose MCP.
Q: Is my code stored on ContextForge’s servers? A: The MCP server communicates with ContextForge’s cloud. Review their security docs for what data is transmitted and stored.
Q: How is this different from a shared CLAUDE.md? A: A CLAUDE.md is static text that competes for context window space. ContextForge’s knowledge is stored in a queryable database and retrieved semantically — it does not consume the conversation context directly.
Q: Can I self-host the MCP server? A: The primary distribution is via npm as a managed service. Self-hosting options are not documented in the public docs as of this writing.
Conclusion
ContextForge addresses the fundamental limitation of stateless AI coding sessions: every new conversation starts with a blank slate. By externalizing project knowledge into a persistent, queryable store and connecting it to your AI tools via MCP, it eliminates the “re-explain everything” tax.
The free tier and three-minute setup make it easy to try — if you use Claude Code, Cursor, or Copilot daily, the memory problem is real and this solves it directly. Start with npm install -g contextforge-mcp and npx contextforge-setup.
Related Posts
ai-setup
Recall – Persistent Memory for Claude Code via MCP Hooks
Recall gives Claude Code a permanent memory store that survives session restarts and context compaction. Four hooks capture and restore context automatically — with cloud SaaS or self-hosted options.
2/28/2026
dev-tools
AgentMesh – Define AI Agent Teams in YAML
Define multi-agent AI workflows in YAML and run them locally with one command. AgentMesh brings Docker Compose patterns to AI agent orchestration.
5/28/2026
dev-tools
Superset – Orchestrate 100+ Coding Agents in Parallel
Superset runs Claude Code, Codex, Cursor, and other AI coding agents simultaneously in parallel workspaces. Orchestrate agents, automated workflows, and code.
5/28/2026