Claude Config Editor
Claude Config Editor is a lightweight web tool that helps you clean and optimize your Claude Code/Desktop config files (.claude.json). Analyze project sizes, bulk delete chat histories, export data for backup, manage servers visually, and speed up Cl
What is Claude Config Editor?
Claude Config Editor is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to claude config editor is a lightweight web tool that helps you clean and optimize your claude code/desktop config files (.claude.json). analyze project sizes, bulk delete chat histories, export data fo...
Claude Config Editor is a lightweight web tool that helps you clean and optimize your Claude Code/Desktop config files (.claude.json). Analyze project sizes, bulk delete chat histories, export data for backup, manage servers visually, and speed up Cl
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Claude Config Editor is a lightweight web tool that helps yo
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx claude-config-editorConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Claude Config Editor
Claude Config Editor is a lightweight, zero-dependency web tool that runs locally on port 8765 to help developers inspect, clean, and optimize their Claude Code and Claude Desktop configuration files. It automatically detects .claude.json and claude_desktop_config.json across all platforms, shows project sizes ranked by disk usage, lets you bulk delete chat histories to reclaim space, provides a visual interface for managing MCP server entries, and creates automatic backups before each save. Anyone who finds their Claude config growing to tens of megabytes from accumulated chat history and wants a safe, visual way to manage it will find this tool essential.
Prerequisites
- Python 3.7 or higher installed
- Claude Code or Claude Desktop installed (config files must already exist)
- A modern web browser (Chrome, Firefox, Safari, or Edge)
- No external Python packages required — uses standard library only
Clone the repository
Clone the Claude Config Editor repository to a local directory.
git clone https://github.com/gagarinyury/claude-config-editor.git
cd claude-config-editorStart the local web server
Run the Python server script. It will start immediately on port 8765 with no dependencies to install.
python3 server.pyOpen the editor in your browser
Navigate to the local URL. The tool will automatically detect your Claude config files on all supported platforms.
open http://localhost:8765Review project sizes and delete large histories
Go to the Project History tab, sort by disk usage, select the largest projects, and click Delete Selected to remove their chat history. The tool creates a .claude.backup.json automatically before saving.
Manage MCP servers visually
Use the MCP Servers tab to view, add, or remove MCP server entries without editing JSON by hand. You can inspect command paths, arguments, environment variables, and working directories through the GUI.
Claude Config Editor Examples
Client configuration
Claude Config Editor is a standalone web tool, not an MCP server itself. Launch it with Python and access it in your browser — no MCP config entry is needed.
{
"_note": "Claude Config Editor runs as a standalone web app, not as an MCP server.",
"_launch": "python3 /path/to/claude-config-editor/server.py",
"_url": "http://localhost:8765"
}Prompts to try
These are tasks you perform directly in the Claude Config Editor web UI rather than via Claude prompts.
- Navigate to 'Project History' tab → sort by disk usage → select top 10 largest → click 'Delete Selected' → Save
- Navigate to 'MCP Servers' tab → click 'Add Server' → fill in command and args → Save
- Navigate to 'Analytics' dashboard → review total config size and health status
- Click 'Export' on a project to back up its chat history as a JSON file before deleting
- Check that a .claude.backup.json was created in the same directory before each save operationTroubleshooting Claude Config Editor
The web UI shows no projects or config files detected.
Verify that Claude Code or Claude Desktop has been run at least once so the config files exist. Check the expected paths: ~/.claude.json for Claude Code on macOS/Linux, or ~/Library/Application Support/Claude/claude_desktop_config.json for Claude Desktop on macOS.
Port 8765 is already in use and the server fails to start.
Find and stop the conflicting process with `lsof -i :8765` and `kill <PID>`, or edit server.py to change the PORT variable to a free port before restarting.
Changes are saved but not reflected in Claude Desktop/Code.
Restart Claude Desktop or Claude Code after saving changes — these applications read their config files at startup, not continuously. If the app still shows old config, verify the editor saved to the correct path shown in the Analytics dashboard.
Frequently Asked Questions about Claude Config Editor
What is Claude Config Editor?
Claude Config Editor is a Model Context Protocol (MCP) server that claude config editor is a lightweight web tool that helps you clean and optimize your claude code/desktop config files (.claude.json). analyze project sizes, bulk delete chat histories, export data for backup, manage servers visually, and speed up cl It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Claude Config Editor?
Follow the installation instructions on the Claude Config Editor GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Claude Config Editor?
Claude Config Editor works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Claude Config Editor free to use?
Yes, Claude Config Editor is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Claude Config Editor Alternatives — Similar Developer Tools Servers
Looking for alternatives to Claude Config Editor? 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 Claude Config Editor 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 Claude Config Editor?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.