Advertise
MCP.so
Sign In

Neovim MCP Server

@bigcodegen

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

bigcodegen

About Neovim MCP Server

Control Neovim using Model Context Protocol (MCP) and the official neovim/node-client JavaScript library

#neovim#mcp#claude#anthropic#modelcontextprotocol

Neovim MCP Server config

Add this server to your MCP-compatible client using the configuration below.

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

Neovim MCP Server tools

19

Get buffer contents with line numbers

Execute Vim commands with optional shell command support

Get comprehensive Neovim status including cursor position, mode, marks, and registers

Edit buffer content using insert, replace, or replaceAll modes

Manage Neovim windows: split, close, and navigate between windows

Set named marks at specific positions in the buffer

Manage Neovim register contents

Create visual mode selections in the buffer

Switch between buffers by name or number

Save current buffer or save to specific filename

Open files into new buffers

Search within current buffer with regex support and options

Find and replace with global, case-insensitive, and confirm options

Project-wide search using vimgrep with quickfix list

Check Neovim connection health

Record, stop, and play Neovim macros

Manage Neovim tabs: create, close, and navigate between tabs

Manage code folding: create, open, close, and toggle folds

Navigate Neovim jump list: go back, forward, or list jumps

Overview

What is Neovim MCP Server?

Neovim MCP Server connects MCP clients like Claude Desktop to a running Neovim instance via a Unix socket. It uses Vim’s native text editing commands and the official neovim/node-client library to provide AI‑assisted code or general text editing. Designed for developers who want to pair an AI assistant directly with their Neovim session.

How to use Neovim MCP Server?

Start Neovim with a socket, e.g. nvim --listen /tmp/nvim. Then configure the MCP server in your MCP client (e.g. Claude Desktop) using the npx -y mcp-neovim-server command. Set the NVIM_SOCKET_PATH environment variable (default /tmp/nvim) and optionally ALLOW_SHELL_COMMANDS=true to enable shell commands via !. The server exposes 19 tools for editing, navigation, search, and window management.

Key features of Neovim MCP Server

  • Connects to a running Neovim instance via a socket file
  • Views and switches between open buffers
  • Retrieves cursor position, mode, filename, marks, registers, and visual selections
  • Runs arbitrary Vim commands and optional shell commands
  • Edits text using insert, replace, or replaceAll modes
  • Search and replace with regex support and project‑wide grep with quickfix integration
  • Health monitoring and connection diagnostics

Use cases of Neovim MCP Server

  • AI‑assisted code editing and refactoring within an existing Neovim session
  • File navigation and buffer switching without leaving the MCP client
  • Project‑wide search and replace with grep and regex
  • Recording and playing back Vim macros via AI prompts
  • Managing windows, tabs, folds, and jumps in Neovim remotely

Frequently asked questions

1

What are the limitations of Neovim MCP Server?

It may not interact well with complex Neovim configurations or plugins. Shell command execution is disabled by default for security. A socket connection is required—it won’t work with standard Vim.

2

How do I enable shell commands?

Set the environment variable `ALLOW_SHELL_COMMANDS` to `'true'` in your MCP client configuration. Default is `false`.

3

What socket path does the server use?

By default it uses `/tmp/nvim`. Override this with the `NVIM_SOCKET_PATH` environment variable.

4

How do I install the server?

You can either download the DXT package from the releases page and drag it to Claude Desktop, or add the `npx -y mcp-neovim-server` command to your `claude_desktop_config.json` with the appropriate environment variables.

5

Does the server require any external runtime?

Yes, it runs via `npx` which requires Node.js. It uses the official neovim/node-client library to communicate with Neovim.

Comments

More Other MCP servers

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K
Advertise