roo-code-custom-mode-editor-mcp-server
About
An MCP server that knows how to edit the Roo Code custom modes file
Explore
- Lists all custom modes in the .roomodes file.
- Creates new custom modes with slug, name, roleDefinition, customInstructions, and groups.
- Retrieves the full fields of a specific custom mode.
- Updates one or more fields of a custom mode without rewriting the entire file.
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:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
roo-code-custom-mode-editor-mcp-serverCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
This server is located at https://github.com/raymondlowe/roo-code-custom-mode-editor-mcp-server and can be run using the following command:
npx https://github.com/raymondlowe/roo-code-custom-mode-editor-mcp-server
To use with Roo Code, add the server config to the MCP settings file:
{
"mcpServers": {
"roo-code-custom-mode-editor": {
"command": "node",
"args": [
"/path/to/roo-code-custom-mode-editor-mcp-server/build/index.js"
],
"disabled": false,
"alwaysAllow": []
}
}
}
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"roo-code-custom-mode-editor-mcp-server": {
"roo-code-custom-mode-editor-mcp-server": {
"command": "npx",
"args": [
"https://github.com/raymondlowe/roo-code-custom-mode-editor-mcp-server"
]
}
}
}
}McpServers
{
"roo-code-custom-mode-editor-mcp-server": {
"command": "npx",
"args": [
"https://github.com/raymondlowe/roo-code-custom-mode-editor-mcp-server"
]
}
}An MCP server that knows how to edit the Roo Code custom modes file
Avoids having to overwrite the .roomodes file using file writes or edit the json with unreliable diffs.
The MCP server exposes tools to:
List all custom modes
Create a new custom mode
Get the fields of a custom mode ( "slug","name", "roleDefinition", "customInstructions", "groups")
Put and overwrite any one or more fields of a custom mode.
Fields are:
- slug : short string
- name : short string
- roleDefinition : long string
- customInstructions : long string
- groups : array of short strings
Usage
This server is located at https://github.com/raymondlowe/roo-code-custom-mode-editor-mcp-server and can be run using the following command:
npx https://github.com/raymondlowe/roo-code-custom-mode-editor-mcp-server
MCP Configuration
To use with Roo Code, add the server config to the MCP settings file:
{
"mcpServers": {
"roo-code-custom-mode-editor": {
"command": "node",
"args": [
"/path/to/roo-code-custom-mode-editor-mcp-server/build/index.js"
],
"disabled": false,
"alwaysAllow": []
}
}
}
Development
Install dependencies:
npm install
Build the server:
npm run build
For development with auto-rebuild:
npm run watch
Debugging
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:
npm run inspector
The Inspector will provide a URL to access debugging tools in your browser.
Tools
list_custom_modes
Lists all custom modes in the.roomodes file.
create_custom_mode
Creates a new custom mode with the specified fields.Parameters:
- slug: string
- name: string
- roleDefinition: string
- customInstructions: string
- groups: string[]
get_custom_mode_fields
Gets the fields of a custom mode.Parameters:
- slug: string
put_custom_mode_fields
Updates one or more fields of a custom mode.Parameters:
- slug: string
- fields: object containing any of the following fields:
- name: string
- roleDefinition: string
- customInstructions: string
- groups: string[]
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
