# alfredoizdev/contextforge-mcp [Health: Active]

**Category:** 🧠 Knowledge & Memory  
**Repository:** https://github.com/alfredoizdev/contextforge-mcp  
**GitHub Stars:** 2  
**npm Downloads (last month):** 843  
**Views:** 9  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/alfredoizdev-contextforge-mcp

## Description
Persistent memory for Claude Code, Cursor, and GitHub Copilot via MCP. Semantic search, Git commit/PR sync, project-based organization, team collaboration. Free tier available. npx contextforge-mcp

## Tools
Capabilities this server exposes over MCP:

- **memory_ingest** — Save knowledge to memory
- **memory_query** — Search your knowledge semantically
- **memory_list_items** — List all stored items
- **memory_delete** — Remove specific items
- **memory_ingest_batch** — Save multiple items at once
- **memory_delete_batch** — Delete items by filter
- **memory_list_spaces** — List your spaces
- **memory_create_space** — Create a new space
- **memory_delete_space** — Delete a space
- **memory_move_space** — Move space to project
- **memory_list_projects** — List your projects
- **memory_create_project** — Create a new project
- **memory_delete_project** — Delete a project
- **memory_link_project** — Link directory to project
- **memory_unlink_project** — Unlink directory
- **memory_current_project** — Show linked project
- **memory_git_connect** — Connect a GitHub repo
- **memory_git_list** — List connected repos
- **memory_git_activate** — Activate/deactivate webhook
- **memory_git_sync** — Import existing history
- **memory_git_commits** — List synced commits
- **memory_git_prs** — List synced PRs
- **memory_git_disconnect** — Disconnect a repo
- **issues_list** — List your issues
- **issues_create** — Create a new issue
- **issues_start** — Mark as in progress
- **issues_resolve** — Mark as resolved
- **issues_resolve_by_name** — Resolve by title
- **issues_assign** — Assign to collaborator
- **issues_what_next** — Get recommendation
- **project_share** — Share project by email
- **collaborators_list** — List collaborators
- **memory_snapshot_create** — Create a backup
- **memory_snapshot_list** — List all snapshots
- **memory_snapshot_restore** — Restore from backup
- **memory_snapshot_delete** — Delete a snapshot
- **memory_export** — Export to JSON/MD/CSV
- **memory_import** — Import from file
- **memory_stats** — View usage statistics
- **memory_relate** — Link two items
- **memory_help** — Show help

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "contextforge-mcp": {
    "command": "npx",
    "args": ["-y","contextforge-mcp"],
    "env": {
      "CONTEXTFORGE_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `CONTEXTFORGE_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What alfredoizdev/contextforge-mcp does

alfredoizdev/contextforge-mcp gives coding assistants a persistent memory layer through the Model Context Protocol. Agents can save project knowledge, search it semantically, enumerate or remove stored items, and organize information into spaces and projects. This is suited to decisions, architecture notes, debugging findings, and other context that should remain available after a chat ends.

The server also connects project knowledge to development activity. GitHub repositories can be connected, existing history can be imported, and synchronized commits and pull requests can be listed. Its issue tools support creating, assigning, starting, resolving, and recommending work. Projects can be linked to local directories so memory operations have a project context.

## How it works

The server communicates with MCP clients over the command launched by `npx -y contextforge-mcp`. It uses the ContextForge service at contextforge.dev and authenticates with an API key generated from that service. Semantic queries search stored knowledge by meaning rather than requiring an exact keyword match.

On connection, the server can provide startup instructions to clients that honor them. Those clients can load project memory at the beginning of a session and save relevant decisions without additional editor configuration. The `init` command can add explicit memory, session-presence, and startup-context rules to a project for clients that do not apply server instructions automatically.

For Claude Code projects, `init` can also add hooks for restoring context after conversation compaction. The generated hooks record session prompts locally and can reintroduce the session objective, relevant memories, recent project memories, and pending tasks.

## Setup and configuration

Create an account at contextforge.dev, generate an API key, and expose it to the MCP process as `CONTEXTFORGE_API_KEY`. The key is then added to the MCP configuration for the selected client.

A typical stdio configuration uses:

```json
{
  "command": "npx",
  "args": ["-y", "contextforge-mcp"],
  "env": {
    "CONTEXTFORGE_API_KEY": "your-api-key-here"
  }
}
```

The package requires Node.js 20 or newer. A global npm installation is optional; using npx fetches the package when needed. Run `npx contextforge-mcp init` from a project directory to generate or update editor-specific memory rules. The command can target Claude Code, Cursor, or both with its editor option.

## Tools and capabilities

- Store, batch-store, search, list, and delete memory items.
- Create, list, move, link, unlink, and delete spaces and projects.
- Connect GitHub repositories, import history, synchronize changes, and inspect commits or pull requests.
- Create and manage issues, including assignment, progress, resolution, and next-task recommendations.
- Maintain project-specific context for linked directories.

## Limitations and notes

Automatic startup behavior depends on whether the MCP client honors server instructions. The generated compaction-recovery hooks are specific to Claude Code. Their relevance search can be disabled with `CONTEXTFORGE_RECALL_RELEVANCE=0`, and recovery requires a linked project. A free tier is available through ContextForge, while service usage and account limits are governed by that platform.

_Full upstream README: https://allmcps.com/mcp/alfredoizdev-contextforge-mcp/readme_