Neovim MCP Server

What is Neovim MCP Server?

A Model Context Protocol (MCP) server for Neovim that provides LSP-based symbol tools, enabling AI language models to interact with Neovim's Language Server Protocol for symbol-level code operations.

How to use Neovim MCP Server?

Install dependencies (Python 3.11+, uv, Neovim 0.9+), clone the repository, and run uv sync. Start Neovim with nvim --listen /tmp/nvim.sock, set the NVIM environment variable to that socket, then run uv run nvim-mcp. Configure with Claude Desktop or Goose using the provided config examples.

Key features of Neovim MCP Server

• LSP-based symbol tools: overview, find, references, rename
• Symbol body replacement and insertion before/after definitions
• General tools: execute Lua and Vimscript code
• Restart language server and query active LSP clients

Use cases of Neovim MCP Server

• AI-assisted code navigation and symbol discovery
• Automated symbol renaming across the codebase
• Inserting or replacing symbol bodies via AI
• Executing Lua/Vimscript commands from language models

FAQ from Neovim MCP Server

What are the prerequisites?

Python 3.11+, the uv package manager, and Neovim 0.9+ with a built-in LSP client.

How do I start the server?

Start Neovim with a socket (e.g., nvim --listen /tmp/nvim.sock), set NVIM to that socket, then run uv run nvim-mcp.

How can I use it with Claude Desktop?

Add the configuration to claude_desktop_config.json using uv as the command and the NVIM environment variable.

What tools are available?

LSP-based symbol tools (overview, find, references, replace, insert, rename) and general tools (execute Lua/Vimscript, restart LSP, get LSP info).

How do I run linting and type checking?

Use uv run ruff check for linting and uv run mypy for type checking (development commands).