Neovim MCP Server

Neovim MCP Server is an MCP server that connects Claude Desktop and other Model Context Protocol clients directly to a running Neovim instance. Built on the official neovim/node-client library, it targets software engineers, terminal enthusiasts, and developers who prefer managing editing environments via AI-assisted tool workflows. The server communicates through a UNIX socket to inspect open buffers, read line numbers, and monitor editor state such as cursor position, active modes, marks, and visual selections. Beyond passive context gathering, it empowers AI assistants to execute core Vim operations, including line insertion, block replacement, regex search and replace, project-wide vimgrep queries, and tab or window management. It also supports Vim macro manipulation, code folding, and optional shell command execution via Vim commands when explicitly enabled. By integrating these editor capabilities into the MCP standard, Neovim MCP Server allows models to navigate codebases and make surgical modifications directly within the developer's native editing session.

Category: Developer Tools & Code Intelligence

Tags: editor, ide, neovim, text-editor

Visit Neovim MCP Server

How to install and configure Neovim MCP Server

1. Start your Neovim session with a socket listener exposed, for example: nvim --listen /tmp/nvim. 2. Open your claude_desktop_config.json file in an editor. 3. Add the server under the mcpServers object: json { "mcpServers": { "MCP Neovim Server": { "command": "npx", "args": [ "-y", "mcp-neovim-server" ], "env": { "ALLOW_SHELL_COMMANDS": "true", "NVIM_SOCKET_PATH": "/tmp/nvim" } } } } 4. Alternatively, download the latest .dxt release file and drag it directly into Claude Desktop. 5. Restart Claude Desktop to initialize the connection.

What you can do with Neovim MCP Server

• Inspecting active buffer contents, cursor coordinates, visual selections, and register values directly from an AI chat interface. * Performing targeted text edits such as inserting, replacing, or rewriting lines in open Neovim buffers programmatically. * Executing multi-file code searches using project-wide vimgrep integration and managing items in the quickfix list. * Automating window operations and workspace navigation including splitting views, switching active tabs, and adjusting code folds. * Running custom Vim navigation and spot editing commands across buffers through standard Vim command calls.

Key facts

• Open Source
• https://github.com/bigcodegen/mcp-neovim-server
• Developer Tools & Code Intelligence
• editor, ide, neovim, text-editor

Part of MCP Servers

What can Neovim MCP Server do?

Neovim MCP Server exposes 19 distinct tools and multiple resources that allow AI clients to read open buffers, track cursor and mode status, search text with regular expressions, run vimgrep across files, make targeted line edits, and control windows, tabs, registers, marks, and code folding.

How do I install Neovim MCP Server?

You can install it manually by adding the npx command for mcp-neovim-server to your claude_desktop_config.json file with the NVIM_SOCKET_PATH environment variable configured. Alternatively, you can download the packaged .dxt release from the repository and drag it into Claude Desktop.

Which MCP clients work with Neovim MCP Server?

It is built for Claude Desktop but works with any Model Context Protocol compliant client capable of running local stdio MCP processes, provided the client connects to an active Neovim instance listening on a local socket.

Does Neovim MCP Server work with standard Vim?

No, it requires Neovim because it depends on the Neovim RPC socket communication layer and the official neovim/node-client library. Standard Vim cannot establish the required socket connection without Neovim's specific architecture.

Is Neovim MCP Server open source?

Yes, Neovim MCP Server is open source software published under the MIT License. The code is freely available for use, modification, and distribution in accordance with the project's repository terms.