IDE Memory MCP

by prasanna00019

125 downloads Not rated yet
GitHub

About

IDE Memory MCP gives AI coding agents a persistent memory layer that works across any IDE supporting the Model Context Protocol. Write project context once — the AI remembers it everywhere.

Explore

- Cross-IDE Memory — Project context persists across Cursor, VS Code, Windsurf, Claude Desktop, and any MCP-compatible IDE
- Context-Optimized — Default reads return a compact summary table, not a context-window-destroying content dump. The AI loads only what it needs.
- Smart Warnings — Automatically detects stale sections (>7 days), oversized content (>10k chars), and suggests pruning when memory gets old (>30 days)
- Agent Prompts — Built-in MCP prompts guide the AI on how to start sessions, bootstrap memory for new projects, and update memory after changes
- Smart Project Matching — Recognizes projects by path or git remote URL. Move folders, switch machines — your memory follows.
- Section-Based Storage — Organized into overview, decisions, active_context, progress + custom sections
- Append Mode — Add incremental updates without rewriting entire sections
- Version History — Previous content auto-saved before each overwrite (last 5 snapshots)
- Zero Config — Works out of the box. No database, no cloud, just local markdown files.

---

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name IDE Memory MCP
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Optional. Create ~/.ide-memory/config.json:

``json
{
"default_sections": [
"overview",
"decisions",
"active_context",
"progress"
]
}
`

---


Run the setup command to automatically detect and configure installed IDEs (Cursor, VS Code, Windsurf, Claude Desktop):

bash ide-memory-mcp setup
` 💡 Restart your IDE after running this command to activate the MCP server. ---

Auto-configure MCP for your IDEs.

`bash
ide-memory-mcp setup # auto-detect + configure all
ide-memory-mcp setup --cursor # configure only Cursor
ide-memory-mcp setup --vscode # configure only VS Code
ide-memory-mcp setup --windsurf # configure only Windsurf
ide-memory-mcp setup --claude # configure only Claude Desktop
ide-memory-mcp setup --all # configure all supported


json
{
"mcpServers": {
"ide-memory": {
"command": "ide-memory-mcp"
}
}
}

bash
pip install dist/ide_memory_mcp-1.0.0-py3-none-any.whl
``

---

IDE Memory MCP exposes 4 optimized tools to the AI agent:

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "ide memory mcp": {
            "IDE-Memory-MCP": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "ide-memory-mcp"
                ]
            }
        }
    }
}

McpServers

{
    "IDE-Memory-MCP": {
        "command": "uv",
        "args": [
            "pip",
            "install",
            "ide-memory-mcp"
        ]
    }
}
<p align="center"> IDE Memory MCP </p> > Cross-IDE persistent memory for AI coding agents — your AI remembers every project, across every IDE. Python 3.11+ License: MIT MCP ---

The Problem

Every time you open a project in a new IDE or start a fresh AI conversation, your AI assistant forgets everything: - What the project does - Architecture decisions you've made - What you're currently working on - Your progress and milestones You end up repeating yourself. Every. Single. Time.

The Solution

IDE Memory MCP gives AI coding agents a persistent memory layer that works across any IDE supporting the Model Context Protocol. Write project context once — the AI remembers it everywhere. `` Cursor ←──→ IDE Memory MCP ←──→ VS Code ↑ ↓ ↑ └── same project memory ────────┘ ` ---

Key Features

- Cross-IDE Memory — Project context persists across Cursor, VS Code, Windsurf, Claude Desktop, and any MCP-compatible IDE - Context-Optimized — Default reads return a compact summary table, not a context-window-destroying content dump. The AI loads only what it needs. - Smart Warnings — Automatically detects stale sections (>7 days), oversized content (>10k chars), and suggests pruning when memory gets old (>30 days) - Agent Prompts — Built-in MCP prompts guide the AI on how to start sessions, bootstrap memory for new projects, and update memory after changes - Smart Project Matching — Recognizes projects by path or git remote URL. Move folders, switch machines — your memory follows. - Section-Based Storage — Organized into
overview, decisions, active_context, progress + custom sections - Append Mode — Add incremental updates without rewriting entire sections - Version History — Previous content auto-saved before each overwrite (last 5 snapshots) - Zero Config — Works out of the box. No database, no cloud, just local markdown files. ---

Quick Start

1. Install

``bash
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.