--- title: "Nx MCP Server: Monorepo Context, Nx Docs and CI for AI" url: "https://mcpshelf.co/servers/nx" description: "Nx's own server gives an assistant your monorepo's project graph, generators, running tasks, Nx docs and Nx Cloud CI results. Setup with npx." updated: "2026-10-27" site: "MCP Shelf" --- # Nx MCP > Your Nx monorepo's projects, tasks, generators and CI results, for your assistant. Source: https://mcpshelf.co/servers/nx Markdown: https://mcpshelf.co/servers/nx.md Generated: 2026-10-27T13:24:39.210Z ## Facts - **Name:** Nx MCP - **Tagline:** Your Nx monorepo's projects, tasks, generators and CI results, for your assistant. - **Description:** Nx MCP is the Nx team's server that gives an assistant your monorepo's project graph, running tasks, generators, Nx docs and Nx Cloud CI results. - **Repository:** https://github.com/nrwl/nx-console - **Package:** nx-mcp 0.25.0 (npm) - **Install:** `claude mcp add nx -- npx nx-mcp@latest /path/to/your/workspace` - **Transport:** stdio (local) - **Auth:** No required keys or settings listed - **Tools exposed:** 13: `nx_docs`, `nx_available_plugins`, `nx_visualize_graph`, `nx_current_running_tasks_details`, `nx_current_running_task_output`, `nx_workspace`, `nx_workspace_path`, `nx_project_details`, `nx_generators`, `nx_generator_schema`, `ci_information`, `ci_task_output`, `update_self_healing_fix` - **Category:** Developer tools (https://mcpshelf.co/categories/developer-tools) - **Stats:** 1.4K GitHub stars, last commit 27 Oct 2026, 0 upvotes on MCP Shelf - **Install check:** Needs your setup first - **Listed:** 2026-10-27 - **Page updated:** 2026-10-27 ## Full description ### What is Nx MCP? **Nx MCP is the Nx team's server that gives an assistant your monorepo's project graph, running tasks, generators, Nx docs and Nx Cloud CI results.** The Nx team ships this server alongside Nx Console. Nx already knows how a monorepo fits together, and the server passes that on: which projects exist and depend on each other, what targets they have, which generators are available and what options they take, and the current Nx documentation. It can also show the output of tasks you are running in the terminal. If the workspace uses Nx Cloud, the model can read the CI pipeline for your branch, pull the log of a failed task, and accept or reject a self-healing fix that Nx Cloud proposed. By default it starts in a minimal mode with only a few tools, because coding agents often learn the workspace through Nx skills instead. | | | | --- | --- | | Made by | Nrwl, the Nx team (nrwl/nx-console) | | GitHub | https://github.com/nrwl/nx-console | | Licence | MIT | | npm package | [nx-mcp](https://www.npmjs.com/package/nx-mcp) 0.25.0 (30 Apr 2026) | | GitHub stars | 1.4K | | Last commit | 27 Oct 2026 | | Tools | 13 | | Runs on | Your computer | | Install check | Needs your setup first | | Category | [Developer tools](https://mcpshelf.co/categories/developer-tools) | | Setup checked | 27 Oct 2026 | | Page updated | 27 Oct 2026 | **Our check:** It needs something our Linux test machine does not have (an account, a desktop app, a Mac or a running service), so on 27 Oct 2026 we read its tools from the source code instead of running this config. #### MCP Shelf take > Nx needs something our Linux test machine does not have (an account, an app or a service), so on 27 Oct 2026 we read its source and counted 13 tools. 11 of the 13 only read; the other 2 can change things. It sits 18th of 21 in its category on our shelf by GitHub stars (1.4K). — MCP Shelf tests (numbers from our own runs), tested on 27 Oct 2026 ### What tools does Nx MCP have? We listed 13 tools on 27 Oct 2026. 11 only read; the rest can change things or run commands. | Tool | Kind | What it is for | | --- | --- | --- | | `nx_docs` | reads | Returns the parts of the Nx docs that answer a question. | | `nx_available_plugins` | reads | Lists the official Nx plugins and any local ones. | | `nx_visualize_graph` | changes | Opens the project or task graph in your editor. Needs Nx Console. | | `nx_current_running_tasks_details` | reads | Lists running Nx commands and the status of their tasks. | | `nx_current_running_task_output` | reads | Returns the terminal output of one running task. | | `nx_workspace` | reads | Describes the project graph and nx.json. Hidden in minimal mode. | | `nx_workspace_path` | reads | Returns the workspace root. Hidden in minimal mode. | | `nx_project_details` | reads | Returns one project's full configuration. Hidden in minimal mode. | | `nx_generators` | reads | Lists the generators you can run. Hidden in minimal mode. | | `nx_generator_schema` | reads | Returns the options of one generator. Hidden in minimal mode. | | `ci_information` | reads | Shows the Nx Cloud CI run for your branch and its failed tasks. | | `ci_task_output` | reads | Returns the log of a failed CI task. | | `update_self_healing_fix` | changes | Applies, rejects or reruns a fix Nx Cloud proposed for a failed run. | ### How do I install Nx MCP? #### What you need first - Node.js - An Nx workspace (Nx 15 or newer) - Nx Cloud, for the CI tools #### Claude Code Where: Your terminal, in the project folder ```bash claude mcp add nx -- npx nx-mcp@latest /path/to/your/workspace ``` The Nx README's shorter form, claude mcp add nx-mcp npx nx-mcp@latest, works from the workspace folder. Add --no-minimal at the end for the project and generator tools. #### Cursor Where: ~/.cursor/mcp.json, or .cursor/mcp.json in a project ```json { "mcpServers": { "nx": { "command": "npx", "args": [ "nx-mcp@latest", "/path/to/your/workspace" ] } } } ``` Easier: install the Nx Console extension in Cursor and it manages this server for you, including graph visualisation. #### Claude Desktop Where: claude_desktop_config.json (Settings → Developer → Edit Config) ```json { "mcpServers": { "nx": { "command": "npx", "args": [ "nx-mcp@latest", "/path/to/your/workspace" ] } } } ``` #### VS Code Where: .vscode/mcp.json in your project ```json { "servers": { "nx": { "type": "stdio", "command": "npx", "args": [ "nx-mcp@latest", "/path/to/your/workspace" ] } } } ``` #### Windsurf Where: ~/.codeium/windsurf/mcp_config.json ```json { "mcpServers": { "nx": { "command": "npx", "args": [ "nx-mcp@latest", "/path/to/your/workspace" ] } } } ``` #### ChatGPT Where: Not supported ChatGPT only connects to remote servers by URL. This one runs on your computer, so use Claude, Cursor or VS Code. The path tells the server which workspace to read; without it, it uses the folder the client starts in. Add "--no-minimal" to turn on the workspace, project and generator tools. In VS Code or Cursor, the Nx Console extension can set this up for you. Checked against the project's own install docs on 27 Oct 2026: https://github.com/nrwl/nx-console/blob/master/apps/nx-mcp/README.md, https://nx.dev/docs/features/enhance-ai ### How do I configure Nx MCP? | Setting | Kind | Required | What it does | | --- | --- | --- | --- | | `workspace path` | flag | no | The first argument: the Nx workspace to read. Defaults to the folder the client starts in. Example: `/Users/you/code/my-repo` | | `--no-minimal` | flag | no | Turns on the workspace, project and generator tools that minimal mode hides. | | `--tools` | flag | no | Only load matching tools. Patterns and ! exclusions work. Example: `--tools "nx_docs" "!ci_*"` | | `--transport` | flag | no | http serves the server on a port (9921 by default, set with --port) so several clients can share it. Example: `--transport http --port 9921` | | `--disableTelemetry` | flag | no | Turns off usage telemetry. | | `.nx/nx-mcp-config.json` | config | no | The same options as a file in the workspace root, for when an editor starts the server for you. Command-line flags win. | ### What can Nx MCP read and change? **It can read** - Your workspace's project graph, nx.json and project configuration - Output of Nx tasks running in your terminal - Nx Cloud CI results for your branch, if you use Nx Cloud **It can change** - Self-healing fixes in Nx Cloud, when asked to apply or reject one - Your editor's view, when it opens the graph **Safer setup:** Minimal mode is already small. Exclude update_self_healing_fix with --tools "!update_self_healing_fix" if you do not want the model to act on CI fixes. ### Good for - Asking which projects a change will affect - Running the right generator with the right options - Finding out why CI failed on your branch ### Nx MCP not working? Common fixes **Only nx_docs and nx_available_plugins appear** The server did not find a workspace. Pass the workspace path as the first argument. **Generator and project tools are missing** That is minimal mode. Add --no-minimal. **The CI tools are missing** They need the workspace to be connected to Nx Cloud. **nx_visualize_graph does nothing** It needs VS Code or a JetBrains IDE open with Nx Console installed. ### What are the alternatives to Nx MCP? | Server | What it does | Tools | Runs on | Licence | Stars | | --- | --- | --- | --- | --- | --- | | [Nx MCP](https://mcpshelf.co/servers/nx) | Your Nx monorepo's projects, tasks, generators and CI results, for your assistant. | 13 | Your computer | MIT | 1.4K | | [Jupyter MCP Server](https://mcpshelf.co/servers/jupyter) | Lets an assistant edit and run cells in a live Jupyter notebook and read the results. | 18 | Your computer | BSD | 1.3K | | [Burp Suite MCP](https://mcpshelf.co/servers/burp-suite) | Lets an assistant send requests, read proxy history and use Repeater in Burp Suite. | 27 | Your computer | GPL-3.0 | 1.3K | | [Ref MCP](https://mcpshelf.co/servers/ref) | Docs search for coding agents that returns only the part of the page that matters. | 2 | Your computer or hosted | MIT | 1.2K | | [Desktop Commander](https://mcpshelf.co/servers/desktop-commander) | A terminal, file search and surgical file edits for your assistant. | 25 | Your computer | MIT | 10.1K | | [Serena](https://mcpshelf.co/servers/serena) | IDE-style "find symbol" and "edit symbol" for an agent, backed by language servers. | 3 (REPL) | Your computer | GPL-3.0 | 30.8K | ### Nx MCP FAQ #### How do I add Nx MCP to Claude Code? From your workspace folder run claude mcp add nx-mcp npx nx-mcp@latest. Add the workspace path if you start Claude elsewhere, and --no-minimal for the project and generator tools. #### How do I use Nx MCP in Cursor or VS Code? Install the Nx Console extension, which sets the server up for you, or add an entry that runs npx nx-mcp@latest. In VS Code you can also use code --add-mcp with that command. #### Do I need Nx Console? No. npx nx-mcp works on its own. Nx Console only sets it up in VS Code, Cursor and JetBrains, and it is needed for graph visualisation. #### Why is Nx MCP minimal mode the default? Many coding agents learn about the workspace through Nx skills, so the Nx team hides the overlapping workspace tools to save context. --no-minimal brings them back. #### Does it run builds or tests for me? No. It reads the tasks you already have running and their output, and the model can suggest commands, but it does not start builds itself. #### What do the Nx Cloud tools do? With Nx Cloud connected, the assistant can read CI pipeline results and failed task logs, and act on self-healing fix suggestions. #### Does Nx MCP work with ChatGPT? Not as set up here. It reads a workspace on your machine, and ChatGPT only connects to servers by public URL. Its HTTP mode on port 9921 is meant for local clients. #### Is Nx MCP free? The server is free under the MIT licence. Nx Cloud, which the CI tools need, has its own plans. Full docs on GitHub: https://github.com/nrwl/nx-console ## Notes for agents Fetch these instead of parsing the HTML page: - llms.txt: https://mcpshelf.co/llms.txt - llms-full.txt: https://mcpshelf.co/llms-full.txt - ai.txt: https://mcpshelf.co/ai.txt - Full catalog (.md): https://mcpshelf.co/catalog.md - API spec: https://mcpshelf.co/openapi.json - MCP server: https://mcpshelf.co/mcp - MCP manifest: https://mcpshelf.co/.well-known/mcp.json - Developer docs: https://mcpshelf.co/developers MCP endpoint (Streamable HTTP, no key): https://mcpshelf.co/mcp. REST API: https://mcpshelf.co/api/v1.