bigcodegen avatar

Neovim

bigcodegen/mcp-neovim-server

The Mcp Neovim Server connects Claude and other Model Context Protocol clients to Neovim instances by exposing a comprehensive set of tools for buffer management, text editing, navigation, and search operations. It provides capabilities including buffer viewing and switching, cursor tracking, vim command execution, multi-mode text editing (insert/replace/replaceAll), regex-based search and replace, project-wide grep with quickfix integration, window management, and connection diagnostics through resources like `nvim://session` and `nvim://buffers`. This server enables AI-assisted code editing and text manipulation by allowing Claude to understand and control Neovim workflows directly through native vim commands that it already comprehends.

GitHub stars
312
tools
19
last updated
Mar 6, 2026

Tools

19 tools

Public tool metadata for what this MCP can expose to an agent.

vim_bufferGet buffer contents with line numbers (supports filename parameter)

Get buffer contents with line numbers (supports filename parameter)

No parameter schema in public metadata yet.

vim_commandSend a command to VIM for navigation, spot editing, and line deletion

Send a command to VIM for navigation, spot editing, and line deletion

No parameter schema in public metadata yet.

vim_statusGet comprehensive Neovim status

Get comprehensive Neovim status

No parameter schema in public metadata yet.

vim_editEdit lines using insert, replace, or replaceAll modes

Edit lines using insert, replace, or replaceAll modes

No parameter schema in public metadata yet.

vim_windowManipulate Neovim windows (split, vsplit, close, navigate)

Manipulate Neovim windows (split, vsplit, close, navigate)

No parameter schema in public metadata yet.

vim_markSet named marks at specific positions

Set named marks at specific positions

No parameter schema in public metadata yet.

vim_registerSet content of registers

Set content of registers

No parameter schema in public metadata yet.

vim_visualCreate visual mode selections

Create visual mode selections

No parameter schema in public metadata yet.

vim_buffer_switchSwitch between buffers by name or number

Switch between buffers by name or number

No parameter schema in public metadata yet.

vim_buffer_saveSave current buffer or save to specific filename

Save current buffer or save to specific filename

No parameter schema in public metadata yet.

vim_file_openOpen files into new buffers

Open files into new buffers

No parameter schema in public metadata yet.

vim_searchSearch within current buffer with regex support

Search within current buffer with regex support

No parameter schema in public metadata yet.

vim_search_replaceFind and replace with advanced options

Find and replace with advanced options

No parameter schema in public metadata yet.

vim_grepProject-wide search using vimgrep with quickfix list

Project-wide search using vimgrep with quickfix list

No parameter schema in public metadata yet.

vim_macroRecord, stop, and play Vim macros

Record, stop, and play Vim macros

No parameter schema in public metadata yet.

vim_tabComplete tab management

Complete tab management

No parameter schema in public metadata yet.

vim_foldCode folding operations

Code folding operations

No parameter schema in public metadata yet.

vim_jumpJump list navigation

Jump list navigation

No parameter schema in public metadata yet.

vim_healthCheck Neovim connection health and socket status

Check Neovim connection health and socket status

No parameter schema in public metadata yet.

Sponsors

Readme

Neovim MCP Server

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.

mcp-neovim-server MCP server

Features

  • 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
  • Project-wide grep search with quickfix integration
  • Comprehensive window management
  • Health monitoring and connection diagnostics

API

Resources


View the full README on GitHub

Details

Repository
github.com/bigcodegen/mcp-neovim-server