# Nx MCP

> Nx MCP is an open-source MCP server for developer tools. MCP server giving AI coding assistants access to Nx monorepo structure, tasks and docs. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, vscode, self-hosted
- **Repository:** https://github.com/nrwl/nx-console/tree/HEAD/apps/nx-mcp
- **MCP Registry name:** io.github.nrwl/nx-mcp
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

The README says the server exposes an Nx workspace to LLM clients: project relationships, file-to-project mappings, runnable tasks, ownership details, tech stacks, generators and Nx documentation. Its stated purpose is to let a model write code that fits a particular workspace and to estimate how a change ripples through connected projects.

It runs over stdio by default and is launched with npx as the nx-mcp package. It can also serve Streamable HTTP on loopback, with an optional host flag for container setups. A minimal mode is on by default and hides workspace analysis tools that overlap with agent skills, and a config file at .nx/nx-mcp-config.json can adjust tool selection and transport.

The server is aimed at developers working in Nx monorepos. Nx Cloud CI tools and CI pipeline resources appear only when a workspace is connected to Nx Cloud.

## Features

- **Workspace graph access:** Exposes project relationships, file mappings and runnable tasks from the Nx workspace to the client.
- **Nx documentation lookup:** Returns documentation sections relevant to a user's question about Nx.
- **Generator discovery:** Lists Nx generators and returns their JSON schemas when minimal mode is disabled.
- **Running task inspection:** Reports currently running Nx TUI processes, task statuses and terminal output.
- **Nx Cloud CI tools:** Retrieves CI pipeline information and failed task output when connected to Nx Cloud.
- **Configurable transport and tools:** Supports stdio or HTTP transport, a minimal mode toggle and a JSON config file for tool selection.

## Good for

- Giving an AI assistant context about project boundaries before editing a monorepo
- Checking which projects and tasks a change may affect
- Looking up Nx documentation while working in a coding assistant
- Inspecting failed CI tasks from Nx Cloud without leaving the editor

## Install

### Claude Code (Terminal)

```sh
claude mcp add nx-mcp -- npx -y nx-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "nx-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "nx-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "nx-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "nx-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "nx-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "nx-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "nx-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "nx-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "nx-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "nx-mcp"
      ]
    }
  }
}
```

## FAQ

### How do I run the Nx MCP server?

The README shows running it through npx with nx-mcp@latest over stdio, or using the Nx Console extension in Cursor, which manages the server automatically.

### Does the HTTP transport require authentication?

The README says the server has no authentication, so it listens only on loopback addresses by default and rejects requests with non-local Host or Origin headers.

### Why are some workspace tools missing by default?

In minimal mode, which is the default, tools such as nx_workspace and nx_generators are hidden. The README says they can be enabled with the --no-minimal flag.

### Is Nx MCP free?

Yes. Nx MCP is open source, so you can use and self-host it for free.

### How do I add Nx MCP to Claude Code?

Run this command in your terminal: claude mcp add nx-mcp -- npx -y nx-mcp

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

---
Source: https://ai-powered.com/mcp/nx-mcp
