nvim-mcp

nvim-mcp is an MCP server that lets AI assistants (Cursor, Claude, and others) control a running Neovim session: open buffers, move the cursor, run LSP actions, inspect layout, and more. It talks to Neovim over its default socket via pynvim, discovers instances automatically, and exposes four tools.

Platforms: Linux and macOS only.

Install

uv tool install nvim-mcp

Or run without installing:

uvx nvim-mcp

Quick start

1. Start Neovim (it listens on an RPC socket by default).
2. Set up your MCP client and agent rules — see config/ for everything you need.
3. The assistant can now control Neovim through 4 tools.

Tools

Tool	Purpose
nvim_send	The universal interface. Send any ex command, Vimscript expression, or key sequence to Neovim. Three modes: command, eval, keys.
nvim_state	Structured snapshot: current file, cursor position, mode, window layout, modified buffers, cwd, and more.
nvim_connect	Connect to a Neovim instance. Auto-connects when only one exists; lists all when multiple are found.
nvim_recipes	Browse operation recipes by category (files, navigation, buffers, windows, marks, registers, folds, LSP).

Multi-instance

One Neovim instance running? Tools auto-connect. Multiple? nvim_connect lists them — pick by index, socket_path, or terminal_pid. Set NVIM_SOCKET_PATH to skip discovery entirely.

Setup

See config/ for MCP client registration (Cursor, Claude Desktop, Claude CLI) and example agent rule files.

Requirements

• Python ≥ 3.10
• Linux or macOS
• Neovim with RPC socket enabled (default)

License

MIT — see LICENSE.