Next.js DevTools — Claude Code MCP server: what it does
Next.js DevTools — an MCP server that hands your coding agent Next.js tooling: upgrade guidance, Cache Components setup, and live data from a running dev server.
no license updated 2026-10-29
Open on GitHubWhat Next.js DevTools does
It runs through npx and registers a set of Next.js tools inside the MCP client. From there an agent can take a project through the move to Next.js 16 or switch on Cache Components. A knowledge base for version 16 comes bundled, split into focused resources that load on demand instead of filling the context window.
With experimental.mcpServer enabled, the agent also talks to your running dev server. It reads actual routes, compiler diagnostics and error state rather than inferring them from source files. Browser automation goes through Playwright, and prebuilt prompts such as upgrade-nextjs-16 handle the routine cases.
Node.js v20.19 is the floor, or a newer LTS release, along with npm or pnpm. Anything older will not start the server. On Windows 11, Codex users add SystemRoot and PROGRAMFILES to .codex/config.toml and raise the startup window to startup_timeout_ms = 20_000.
What it helps with
- Move a Next.js app to version 16 without guessing the order of steps
- Turn on Cache Components and get
use cacheright - Read the real route list from a running dev server
- Surface compiler errors without tailing terminal output
- Run a Playwright check against a page
Example prompts for the agent
- Next Devtools, walk me through upgrading this app to Next.js 16
- Next Devtools, what routes does my dev server actually have?
- Next Devtools, show me the compiler errors from the running server
How to install Next.js DevTools
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Next.js DevTools
How do I install Next.js DevTools in Claude Code?
Run claude mcp add next-devtools npx next-devtools-mcp@latest. The manual route works too: put an mcpServers entry in your MCP settings file with command npx and args -y, next-devtools-mcp@latest.
What does Next.js DevTools do?
It gives the assistant tools for Next.js upgrades and Cache Components setup, a version 16 knowledge base, task prompts and Playwright integration. With experimental.mcpServer on, it also reads state and errors from your running dev server.
What do I need before installing it?
Node.js v20.19 or a newer LTS release, plus npm or pnpm. For the dev-server features you need Next.js 16 or later with experimental.mcpServer enabled and the server restarted via npm run dev.