reformat_file: Modifies formatting without confirmation
Troubleshooting
Issue
Solution
Connection refused
Verify IDEA running with MCP plugin
Request timed out
Accept permission dialog in IDEA
File not found
Check absolute vs relative path
No occurrences found
Verify projectPath and file paths
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: dtprj-dongting-idea-mcp3description: IntelliJ IDEA MCP Skill4---56# IntelliJ IDEA MCP Skill78## Critical Requirements910- **IDEA MUST be running** with MCP server connected11- **Permission dialogs** in IDEA must be accepted for commands to execute1213## Path Rules (Most Common Error Source)1415| Parameter | Path Type | Example |16|-----------|-----------|---------|17| `projectPath` | **ABSOLUTE** | `/Users/huangli/dt/dongting` |18| `filePath`, `pathInProject`, `directoryPath` | **RELATIVE** | `server/src/main/java/...` |1920## Key Workflows2122### Check Compilation Errors23```yaml24Tool: IntelliJ-IDEA_get_file_problems25Parameters:26 projectPath: "/Users/huangli/dt/dongting"27 filePath: "server/src/main/java/.../SomeFile.java"28 errorsOnly: true29```30More accurate than LSP for multi-module Maven projects.3132### Run Tests33```yaml34Tool: IntelliJ-IDEA_execute_run_configuration35Parameters:36 projectPath: "/Users/huangli/dt/dongting"37 configurationName: "TtlManagerTest"38 timeout: 120000 # 2 minutes for tests39```4041### Search Code42```yaml43Tool: IntelliJ-IDEA_search_in_files_by_text44Parameters:45 projectPath: "/Users/huangli/dt/dongting"46 searchText: "DtLog.getLogger"47 caseSensitive: true48```4950### Safe Refactoring511. Search first: `search_in_files_by_text` to understand scope522. Rename: `rename_refactoring` with `symbolName` and `newName`533. Verify: `get_file_problems` to check for errors5455## Tool Selection Guide5657| Task | Best Tool | Why |58|------|-----------|-----|59| Java errors/warnings | IDEA `get_file_problems` | More accurate than LSP |60| Run tests | IDEA `execute_run_configuration` | Proper test environment |61| Rename refactoring | IDEA `rename_refactoring` | Semantic, cross-file updates |62| Search code | IDEA `search_in_files_by_*` | Fast indexed search |63| Find files | IDEA `find_files_by_*` | Fast indexed search |64| Read files | LSP `read` or IDEA `get_file_text_by_path` | Either works |65| Build/compile | Bash `mvn` | More control, reproducible |66| Git operations | Bash `git` | IDEA MCP lacks git tools |6768## Timeout Recommendations6970| Operation | Timeout |71|-----------|---------|72| File/text search | 30000-60000 |73| Get file problems | 15000 |74| Run configuration | 120000-300000 |75| Build project | 300000 |76| Refactoring | 60000 |7778## High-Risk Operations7980- `execute_terminal_command`: Runs ANY shell command with full system permissions81- `rename_refactoring` & `replace_text_in_file`: Modifies code globally82- `create_new_file`: Creates files immediately83- `reformat_file`: Modifies formatting without confirmation8485## Troubleshooting8687| Issue | Solution |88|-------|----------|89| Connection refused | Verify IDEA running with MCP plugin |90| Request timed out | Accept permission dialog in IDEA |91| File not found | Check absolute vs relative path |92| No occurrences found | Verify `projectPath` and file paths |9394---95> Converted and distributed by [TomeVault](https://tomevault.io/claim/dtprj) — claim your Tome and manage your conversions.96<!-- tomevault:4.0:skill_md:2026-04-11 -->
Run npx skillmds@latest add tomevault-io/dtprj-dongting-idea-mcp in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
IntelliJ IDEA MCP Skill It is listed under AI & ML on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.
tomevault-io