SSyncDev

MCP Neovim Server MCP Server

An MCP server for neovim

Local serverstdio

What is the MCP Neovim Server MCP Server?

An MCP server for neovim

The short version

Connect Claude Desktop (or any Model Context Protocol client) to Neovim using MCP and the official neovim/node-client JavaScript library. This server leverages Vim's native text editing commands and workflows, which Claude already understands, to create a lightweight code or general purpose AI text assistance layer.

  • Connects to your nvim instance if you expose a socket file, for example --listen /tmp/nvim, when starting nvim
  • Views your current buffers and manages buffer switching
  • Gets cursor location, mode, file name, marks, registers, and visual selections
  • Runs vim commands and optionally shell commands through vim
  • Can make edits using insert, replace, or replaceAll modes
  • Search and replace functionality with regex support

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
vim_bufferGet buffer contents with line numbers (supports filename parameter)
vim_commandSend a command to VIM for navigation, spot editing, and line deletion
vim_statusGet comprehensive Neovim status
vim_editEdit lines using insert, replace, or replaceAll modes
insertinsert lines at startLine
replacereplace lines starting at startLine
replaceAllreplace entire buffer contents
vim_windowManipulate Neovim windows (split, vsplit, close, navigate)
vim_markSet named marks at specific positions
vim_registerSet content of registers
vim_visualCreate visual mode selections
vim_buffer_switchSwitch between buffers by name or number
vim_buffer_saveSave current buffer or save to specific filename
vim_file_openOpen files into new buffers
vim_searchSearch within current buffer with regex support
vim_search_replaceFind and replace with advanced options
vim_grepProject-wide search using vimgrep with quickfix list
vim_macroRecord, stop, and play Vim macros
vim_tabComplete tab management
vim_foldCode folding operations
vim_jumpJump list navigation
vim_healthCheck Neovim connection health and socket status

How to install the MCP Neovim Server MCP Server

{
  "mcpServers": {
    "MCP Neovim Server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-neovim-server"
      ],
      "env": {
        "ALLOW_SHELL_COMMANDS": "true",
        "NVIM_SOCKET_PATH": "/tmp/nvim"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
ALLOW_SHELL_COMMANDSDeclared in the maintainer’s client configuration.Check documentation
NVIM_SOCKET_PATHDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use MCP Neovim Server to vim buffer.”
  • “Use MCP Neovim Server to vim command.”
  • “Use MCP Neovim Server to vim status.”

Frequently asked questions

An MCP server for neovim Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.