Mode Manager
MCP Memory Agent Server - A VS Code chatmode and instruction manager with library integration
What is Mode Manager?
Mode Manager is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp memory agent server - a vs code chatmode and instruction manager with library integration
MCP Memory Agent Server - A VS Code chatmode and instruction manager with library integration
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP Memory Agent Server - A VS Code chatmode and instruction
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mode-managerConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Mode Manager
Mode Manager MCP Server is a VS Code memory and instruction management system that lets AI assistants read, write, and organize persistent instructions across three scopes: personal preferences, workspace/team conventions, and language-specific coding standards—all stored as Markdown instruction files that VS Code Copilot Chat understands natively.
Prerequisites
- Python 3.10 or higher
- uv package manager (pip install uv or pipx install uv)
- VS Code with GitHub Copilot Chat extension enabled
- An MCP-compatible client such as VS Code Copilot Chat or Claude Desktop
- No external API keys required
Install uv if not already available
Mode Manager MCP is distributed as a Python package and relies on uv for zero-config execution via uvx.
pip install uv
# or using pipx
pipx install uvAdd to VS Code MCP configuration
Create or edit .vscode/mcp.json in your workspace (or the global mcp.json) and add the mode-manager server entry using uvx.
{
"servers": {
"mode-manager": {
"command": "uvx",
"args": ["mode-manager-mcp"]
}
}
}Alternative: install from GitHub for the latest version
If you need the most recent unreleased features, point uvx at the GitHub repository directly.
{
"servers": {
"mode-manager": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/NiclasOlofsson/mode-manager-mcp.git",
"mode-manager-mcp"
]
}
}
}Add to Claude Desktop (optional)
If you also want Mode Manager available in Claude Desktop, add it to claude_desktop_config.json.
{
"mcpServers": {
"mode-manager": {
"command": "uvx",
"args": ["mode-manager-mcp"]
}
}
}Run the onboarding flow
After reloading VS Code, trigger the interactive onboarding command in Copilot Chat to set up your personal and workspace memory files.
/mcp.mode-manager.onboardingVerify memory scopes are working
Ask the AI to store a preference and confirm a Markdown instruction file was created at the correct path.
# Personal memory stored at:
~/.vscode/memory.instructions.md
# Workspace/team memory stored at:
.github/instructions/memory.instructions.md
# Language-specific (e.g., Python) stored at:
.github/instructions/memory-python.instructions.mdMode Manager Examples
Client configuration
VS Code .vscode/mcp.json configuration using the published PyPI package via uvx.
{
"servers": {
"mode-manager": {
"command": "uvx",
"args": ["mode-manager-mcp"]
}
}
}Prompts to try
Natural language instructions to store and retrieve memory across different scopes.
- "Remember that I prefer type hints and use Black formatting in all Python files"
- "Store for the team: we always use the data-pipeline template and snake_case naming conventions"
- "For Python files, use type hints everywhere. For C#, always enable nullable reference types"
- "What coding preferences have you stored for me?"
- "Forget my personal preference about line length and update it to 100 characters"Troubleshooting Mode Manager
uvx command not found when VS Code tries to start the server
Ensure uv is installed and its binary directory is on the PATH that VS Code uses. You may need to set the full path in the mcp.json command field, e.g., "/usr/local/bin/uvx". Run `which uvx` in your terminal to find the correct path.
Memory files are not being created after asking the AI to remember something
Confirm the onboarding step completed successfully by running /mcp.mode-manager.onboarding in Copilot Chat. Also check that VS Code has write permissions to the .github/instructions/ directory and your home directory.
Team memory is not shared with other developers
The workspace memory file at .github/instructions/memory.instructions.md must be committed to your Git repository so teammates can access it. Personal memory in ~/.vscode/ is intentionally user-local and not committed.
Frequently Asked Questions about Mode Manager
What is Mode Manager?
Mode Manager is a Model Context Protocol (MCP) server that mcp memory agent server - a vs code chatmode and instruction manager with library integration It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Mode Manager?
Follow the installation instructions on the Mode Manager GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Mode Manager?
Mode Manager works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Mode Manager free to use?
Yes, Mode Manager is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Mode Manager Alternatives — Similar Developer Tools Servers
Looking for alternatives to Mode Manager? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Mode Manager in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Mode Manager?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.