The MCP Neovim Server by Bigcodegen integrates AI capabilities directly into Neovim sessions. Built with JavaScript/Node.js and the official neovim/node-client library, this free tool functions as an MCP server. It enables developers and Vim/Neovim users to pair an AI assistant with their preferred command-line editor. The server supports various AI clients, connecting to a running Neovim instance via a Unix socket. It enhances productivity by allowing AI to interact with and control Neovim's core functionalities, making advanced coding assistance readily available within the editor.

What does MCP Neovim Server connect to?

MCP Neovim Server connects to an active Neovim instance, typically established through a Unix socket. This connection method allows the server to act as an intermediary, enabling AI clients to interact with the editor. It operates as a Model Context Protocol server, categorizing it as a productivity and developer tool. The server is compatible with various AI clients, including Claude Desktop, Cursor, VS Code, Claude Code, Gemini, Codex, and Windsurf, all communicating via the stdio transport protocol.

Core features and tools

MCP Neovim Server exposes a set of callable tools for AI interaction with Neovim. These include vim_buffer, vim_command, vim_status, vim_edit, vim_window, vim_mark, vim_register, vim_visual, vim_buffer_switch, vim_buffer_save, vim_file_open, vim_search, vim_search_replace, vim_grep, vim_health, vim_macro, vim_tab, vim_fold, and vim_jump. These tools allow AI assistants to perform actions ranging from basic text manipulation to advanced navigation and project management within the Neovim environment.

Who is it for?

MCP Neovim Server is for Vim/Neovim users seeking AI coding assistance and developers who prefer command-line editors and wish to pair an AI assistant directly with their Neovim session. It caters to those who want to integrate AI capabilities for code editing, refactoring, and project navigation within their familiar Neovim workflow. This is not the right fit if you do not use Neovim or prefer a different editor for your development tasks.

How to get started

No credentials are required. Setup involves ensuring Neovim is listening on a socket, such as by starting it with "nvim --listen /tmp/nvim". The server's operation is configured using environment variables like NVIM_SOCKET_PATH, which defaults to "/tmp/nvim", to specify the Neovim socket path. Additionally, ALLOW_SHELL_COMMANDS can be set to "true" to permit shell commands, with all communication utilizing the stdio transport protocol.

Use cases

• AI-assisted code editing and refactoring, alongside project-wide search and replace operations using grep and regex, for powerful text manipulation.
• Efficient file navigation and buffer switching, coupled with managing windows, tabs, folds, and jumps, to control Neovim's interface.
• Recording and playing back Vim macros, which can be controlled and triggered through AI instructions to automate repetitive tasks.

MCP Neovim Server provides a valuable bridge for integrating AI capabilities into the Neovim editor. Its foundation in JavaScript/Node.js and its array of callable Vim tools make it a powerful addition for developers. The server supports a variety of AI clients, enhancing productivity for those who prefer command-line environments. It allows for advanced AI-driven workflows directly within a familiar editor. Try this by configuring your MCP client to run the server and then using AI for code editing.