mcp-jetbrains-ide

by @vaayne in Development

# Install this skill:

npx skills add vaayne/agent-kit --skill "mcp-jetbrains-ide"

Install specific skill from multi-skill repository

# Description

Control JetBrains IDE (IntelliJ, WebStorm, PyCharm) via MCP. Use when manipulating IDE files, running configurations, searching code, or performing refactoring. Triggers on "open in IDE", "run configuration", "refactor code", "IDE search", "JetBrains".

# SKILL.md

name: mcp-jetbrains-ide
description: Control JetBrains IDE (IntelliJ, WebStorm, PyCharm) via MCP. Use when manipulating IDE files, running configurations, searching code, or performing refactoring. Triggers on "open in IDE", "run configuration", "refactor code", "IDE search", "JetBrains".

JetBrains IDE Integration

MCP service at http://localhost:64342/sse (sse) with 22 tools.

Requirements

mh CLI must be installed. If not available, install with:
bash curl -fsSL https://raw.githubusercontent.com/vaayne/mcphub/main/scripts/install.sh | sh
JetBrains IDE must be running with MCP plugin enabled

Usage

List tools: mh -u http://localhost:64342/sse -t sse list
Get tool details: mh -u http://localhost:64342/sse -t sse inspect <tool-name>
Invoke tool: mh -u http://localhost:64342/sse -t sse invoke <tool-name> '{"param": "value"}'

Notes

Run inspect before invoking unfamiliar tools to get full parameter schema
Timeout: 30s default, use --timeout <seconds> to adjust
SSE port may vary - check IDE MCP plugin settings if connection fails
All file paths are relative to project root unless absolute

Tools

File Operations

Tool	Description
`createNewFile`	Create a new file at specified path, auto-creates parent directories
`getFileTextByPath`	Read file contents by project-relative path
`replaceTextInFile`	Replace text in file with flexible find/replace options
`reformatFile`	Apply code formatting rules to a file
`openFileInEditor`	Open a file in the IDE editor
`getAllOpenFilePaths`	Get paths of all currently open files

Search

Tool	Description
`findFilesByNameKeyword`	Find files by name keyword (case-insensitive)
`findFilesByGlob`	Find files matching glob pattern (e.g. `*/.ts`)
`searchInFilesByText`	Search for text substring across project files
`searchInFilesByRegex`	Search with regex pattern across project files

Code Intelligence

Tool	Description
`getSymbolInfo`	Get documentation/info about symbol at position
`getFileProblems`	Analyze file for errors and warnings
`renameRefactoring`	Rename symbol across entire project

Project

Tool	Description
`listDirectoryTree`	Tree view of directory structure
`getProjectModules`	List all project modules with types
`getProjectDependencies`	List all project dependencies
`getRepositories`	List VCS roots in project

Execution

Tool	Description
`getRunConfigurations`	List available run configurations
`executeRunConfiguration`	Run a specific run configuration
`executeTerminalCommand`	Execute shell command in IDE terminal

Other

Tool	Description
`permissionPrompt`	Permission prompt utility

Examples

# List project structure
mh -u http://localhost:64342/sse -t sse invoke listDirectoryTree '{"path": "."}'

# Search for text in files
mh -u http://localhost:64342/sse -t sse invoke searchInFilesByText '{"query": "TODO"}'

# Read a file
mh -u http://localhost:64342/sse -t sse invoke getFileTextByPath '{"path": "src/index.ts"}'

# Rename a symbol
mh -u http://localhost:64342/sse -t sse invoke renameRefactoring '{"path": "src/utils.ts", "line": 10, "column": 5, "newName": "newFunctionName"}'

# Run a configuration
mh -u http://localhost:64342/sse -t sse invoke executeRunConfiguration '{"name": "Run Tests"}'

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

⚡ Amp 🚀 Antigravity 🤖 Claude Code 🦀 Clawdbot 📝 Codex ▶️ Cursor 🤖 Droid 💎 Gemini CLI 🐙 GitHub Copilot 🪿 Goose 📊 Kilo Code 🔧 Kiro CLI 💻 OpenCode 🦘 Roo Code 🌲 Trae 🏄 Windsurf

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.