nvim-mcp

Overview

nvim-mcp provides AI agents with direct access to a running Neovim instance, allowing them to view buffers, execute commands, edit files in memory, query diagnostics, and more through Neovim's native msgpack-RPC protocol. It supports multiple AI clients including Cursor, Claude Code, Codex, and OpenCode. The server emphasizes safety by working with in-memory operations and preserving undo history before changes are saved to disk.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• get_neovim_state

  Get current Neovim editor state including mode, working directory, buffers, windows, cursor position, folds, selections, marks, and diagnostics.

  Try:What file am I in?Try:Show me the current editor stateTry:What's the cursor position and mode?
• edit_buffer

  Edit buffer contents in memory with find-and-replace or full rewrites.

  Try:Replace all instances of 'foo' with 'bar'Try:Rewrite this function to be more efficientTry:Fix the syntax errors in this code
• run_vim_command

  Execute any Vim command in Neovim.

  Try:Save the current fileTry:Open a vertical splitTry:Run the macro 'q'
• send_keystrokes

  Send keystrokes to Neovim to navigate, enter modes, or trigger mappings.

  Try:Go to beginning of lineTry:Enter insert modeTry:Trigger the leader key mapping
• get_lsp_diagnostics

  Query LSP diagnostics for errors, warnings, and hints across a buffer or the whole session.

  Try:Show me all diagnostics in this fileTry:List all errors in the current bufferTry:What warnings are there in the project?
• add_highlight

  Add colored extmarks to highlight specific lines or code regions.

  Try:Highlight this important functionTry:Mark all TODO comments in yellowTry:Draw attention to the selected lines

Note: Tool names were inferred from the 'What agents can do' section. The actual tool names and signatures may differ and should be verified in the full tool reference (docs/TOOLS.md).

Comparable tools

Installation

curl -LsSf https://astral.sh/uv/install.sh | sh

{
  "mcpServers": {
    "nvim-mcp": {
      "command": "uvx",
      "args": ["nvim-mcp"]
    }
  }
}

{
  "mcpServers": {
    "nvim-mcp": {
      "command": "nix",
      "args": ["run", "github:paulburgess1357/nvim-mcp"]
    }
  }
}

FAQ

Is this plugin required in Neovim?

No, nvim-mcp works with Neovim's native msgpack-RPC socket without requiring any plugins.

What AI clients are supported?

It works with Cursor, Claude Code, Codex, OpenCode, and any MCP-compatible client.

Compare nvim-mcp with