How to add IDE Index MCP Server to Cursor

JetBrains IDE plugin exposing an MCP server so AI agents can use the IDE's indexing and refactoring. Paste the config into ~/.cursor/mcp.json and restart Cursor.

Last updated June 14, 2026 · 254★ · http · no auth

Cursor config for IDE Index MCP Server

claude mcp add --transport http --scope user intellij-index http://127.0.0.1:29170/index-mcp/streamable-http

{
  "mcpServers": {
    "ide-index-mcp-server": {
      "url": "http://127.0.0.1:29170/index-mcp/streamable-http",
      "type": "streamable-http"
    }
  }
}

Remote server — no local install needed. Restart the client after saving the config.

Setup steps

1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
2Paste the IDE Index MCP Server config below into the "mcpServers" object.
3Fill in placeholder secrets, then save.
4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
5Ask Cursor to use one of IDE Index MCP Server's tools to confirm it's connected.

Before you start

JetBrains IDE 2025.1 or later (any IntelliJ Platform-based IDE)
JVM 21 or later
The IDE Index MCP Server plugin installed from JetBrains Marketplace (plugin 29174)
An MCP-compatible client supporting Streamable HTTP (MCP 2025-03-26), e.g. Claude Code, Codex, Cursor, Windsurf

What IDE Index MCP Server can do in Cursor

ide_find_references

Find all references to a symbol across the entire project.

ide_find_definition

Find the definition/declaration location of a symbol.

ide_find_class

Search for classes/interfaces by name with camelCase/substring/wildcard matching.

ide_find_file

Search for files by name using the IDE's file index.

ide_find_symbol

Search for symbols (classes, methods, fields, functions) by name with IntelliJ Go to Symbol matching (disabled by default).

ide_search_text

Text search using the IDE's pre-built word index with context filtering.

ide_diagnostics

Analyze file problems with fresh editor diagnostics for open files or batch diagnostics for closed files, plus optional build/test results.

ide_index_status

Check if the IDE is in dumb mode (indexing) or smart mode.

Security

The server binds to 127.0.0.1 by default and implements no authentication (it does not advertise auth capabilities). Changing Server Host to 0.0.0.0 exposes it for remote/WSL access without any auth, so restrict network access accordingly. Each JetBrains IDE uses a distinct default port to avoid conflicts when multiple IDEs run at once.

IDE Index MCP Server + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the IDE Index MCP Server config there under the "mcpServers" key and restart the client.

Is IDE Index MCP Server safe to use with Cursor?

How do I connect Claude Code to it?

Run the install command (adjust name and port for your IDE), e.g. `claude mcp add --transport http --scope user intellij-index http://127.0.0.1:29170/index-mcp/streamable-http`. You can also use the plugin's 'Install on Coding Agents' button in the tool window.

What port does it use?

Each JetBrains IDE has a distinct default port and server name to avoid conflicts: IntelliJ IDEA 29170 (intellij-index), Android Studio 29171, PyCharm 29172, WebStorm 29173, GoLand 29174, PhpStorm 29175, RubyMine 29176, CLion 29177, RustRover 29178, DataGrip 29179. The port is changeable in Settings > Tools > Index MCP Server.

Does it require authentication?

No. The server binds to 127.0.0.1 by default and does not implement or advertise authentication. If you change the host to 0.0.0.0 for remote/WSL access, it remains unauthenticated, so restrict access at the network level.

View repo Full IDE Index MCP Server page