ContextForge MCP Server

Intelligent contextual memory system for AI-powered development. Store and retrieve knowledge across conversations, perfect for Claude Desktop and Claude Code.

Quick Start

Installation

npm install -g contextforge-mcp

Get Your API Key

1. Go to contextforge.dev
2. Sign up for a free account
3. Navigate to Settings → API Keys
4. Click "Generate API Key"
5. Copy your key (starts with cf_)

Configuration

For Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "contextforge": {
      "command": "contextforge-mcp",
      "env": {
        "CONTEXTFORGE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Restart Claude Desktop and start using your memory!

For Claude Code (CLI)

claude mcp add contextforge \
  -e CONTEXTFORGE_API_KEY=your-api-key-here \
  -- contextforge-mcp

Restart Claude Code and use /mcp to verify it's connected.

Available Tools

ContextForge provides 3 types of functionality: Knowledge Management, GitHub Integration, and Issue Tracking.

Knowledge Management

Store, search, and organize your knowledge.

| Tool | Description | Example | |------|-------------|---------| | memory_ingest | Save knowledge to memory | "Save this: our API uses JWT tokens" | | memory_query | Search your knowledge | "How do we handle authentication?" | | memory_list_items | List all stored items | "Show my saved items" | | memory_delete | Remove specific items | "Delete the item about old API" | | memory_ingest_batch | Save multiple items at once | "Save these 5 code snippets" | | memory_delete_batch | Delete items by filter | "Delete all items tagged 'draft'" |

Spaces & Projects

Organize your knowledge into workspaces.

| Tool | Description | Example | |------|-------------|---------| | memory_list_spaces | List your spaces | "List my spaces" | | memory_create_space | Create a new space | "Create a space called Backend API" | | memory_delete_space | Delete a space | "Delete the old-project space" | | memory_move_space | Move space to project | "Move API space to Mobile project" | | memory_list_projects | List your projects | "Show my projects" | | memory_create_project | Create a new project | "Create project E-commerce App" | | memory_delete_project | Delete a project | "Delete the test project" | | memory_link_project | Link directory to project | "Link this folder to my project" | | memory_unlink_project | Unlink directory | "Unlink this folder" | | memory_current_project | Show linked project | "What project is linked here?" |

GitHub Integration

Automatically sync commits and PRs from your repositories.

| Tool | Description | Example | |------|-------------|---------| | memory_git_connect | Connect a GitHub repo | "Connect github.com/user/repo" | | memory_git_list | List connected repos | "Show my connected repos" | | memory_git_activate | Activate/deactivate webhook | "Activate the webhook" | | memory_git_sync | Import existing history | "Sync last 50 commits" | | memory_git_commits | List synced commits | "Show my recent commits" | | memory_git_prs | List synced PRs | "Show merged PRs this week" | | memory_git_disconnect | Disconnect a repo | "Disconnect the old repo" |

Issue Tracking

Track tasks and collaborate with your team.

| Tool | Description | Example | |------|-------------|---------| | issues_list | List your issues | "What's pending?" | | issues_create | Create a new issue | "Create issue: Fix login bug" | | issues_start | Mark as in progress | "Start working on abc123" | | issues_resolve | Mark as resolved | "Mark issue abc123 as done" | | issues_resolve_by_name | Resolve by title | "Resolve the login bug issue" | | issues_assign | Assign to collaborator | "Assign issue to [email protected]" | | issues_what_next | Get recommendation | "What should I work on next?" |

Collaboration

Share projects and work with your team.

| Tool | Description | Example | |------|-------------|---------| | project_share | Share project by email | "Share project with [email protected]" | | collaborators_list | List collaborators | "Who has access to this project?" |

Snapshots & Export

Backup and export your knowledge.

| Tool | Description | Example | |------|-------------|---------| | memory_snapshot_create | Create a backup | "Create snapshot before refactoring" | | memory_snapshot_list | List all snapshots | "Show my backups" | | memory_snapshot_restore | Restore from backup | "Restore from yesterday's snapshot" | | memory_snapshot_delete | Delete a snapshot | "Delete old snapshot" | | memory_export | Export to JSON/MD/CSV | "Export my API space to markdown" | | memory_import | Import from file | "Import these notes" |

Utility

| Tool | Description | Example | |------|-------------|---------| | memory_stats | View usage statistics | "Show my memory stats" | | memory_relate | Link two items | "Link these two items" | | memory_help | Show help | "How do I use ContextForge?" |

Natural Language Examples

You don't need to memorize commands. Just talk naturally:

# Knowledge
"Save this: we use PostgreSQL for the main database"
"What database do we use?"
"List my spaces"

# GitHub
"Connect my repo github.com/myuser/myproject"
"What commits did I make today?"
"Show PRs merged this week"

# Issues
"Create an issue: Update the login page design"
"What's pending?"
"What should I work on next?"
"Mark the login issue as done"

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | CONTEXTFORGE_API_KEY | Yes | Your API key from the dashboard | | CONTEXTFORGE_DEFAULT_SPACE | No | Default space for operations |

Dashboard

Manage your memories visually at contextforge.dev

• View and organize your knowledge
• Search and filter memories
• Manage API keys
• Track issues and collaborate
• Export and backup data

Support

• Documentation
• Report Issues
• Questions? Email: [email protected]

License

MIT

Built with love by Alfredo Izquierdo