Feature Request: Add 'claude mcp reload' command to reload MCP servers without restarting
Resolved 💬 3 comments Opened Mar 20, 2026 by Brandi-Coon-Asurion Closed Mar 20, 2026
Feature Request: MCP Server Reload Command
Problem
Currently, there's no way to reload MCP server configurations without fully restarting Claude Code. This is particularly problematic when:
- MCP credentials expire - Many MCP servers use bearer tokens or session tokens that expire regularly (e.g., hourly, daily)
- Credential refresh scripts exist - Tools like
refresh-mcp-credentialscan update the~/.claude.jsonfile programmatically, but changes don't take effect until restart - Workflow interruption - Restarting Claude Code loses current conversation context, interrupts active work, and requires reopening files/projects
Use Case
I have 6 MCP servers configured that authenticate via bearer tokens through an internal gateway. These tokens expire regularly and need to be refreshed. The current workflow is:
- Run
refresh-mcp-credentialsscript (updates~/.claude.json) - Restart Claude Code ← This is the painful step
- All MCP servers reconnect with fresh credentials
This happens frequently enough that the restart requirement is a significant productivity loss.
Proposed Solution
Add a new command to reload MCP server configurations:
claude mcp reload [server-name]
Behavior:
claude mcp reload- Reload all MCP serversclaude mcp reload notion-mcp-server- Reload a specific server- Re-reads configuration from
~/.claude.json - Disconnects and reconnects MCP servers with updated credentials
- No need to restart Claude Code
- Preserves current conversation context
Alternative Solutions
If a full reload is complex, even these would help:
- Hot-reload on file change - Automatically detect when
~/.claude.jsonchanges and prompt to reload - Manual reconnect - A UI button or slash command to reconnect a specific MCP server
- Credential refresh API - A programmatic way to update credentials without file edits
Benefits
- Reduces friction in MCP workflows
- Enables automation-friendly credential rotation
- Improves developer experience when working with frequently-expiring tokens
- Aligns with modern dev tools that support hot-reloading of configuration
Related
This would be especially valuable for enterprise environments where:
- SSO tokens expire frequently
- Multiple MCP servers are used simultaneously
- Automated credential refresh scripts are common
- Minimizing workflow interruption is critical
---
Environment:
- Platform: macOS (Darwin 24.6.0)
- Claude Code version: 2.1.80
- MCP Servers: 6 (HTTP transport via internal gateway)
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗