Which integrations are available for this server?

Allows AI assistants to control a running Neovim session by sending ex commands, Vimscript expressions, and key sequences; retrieving structured state snapshots including current file, cursor position, mode, window layout, and modified buffers; managing connections to specific instances; and browsing operation recipes for files, navigation, buffers, windows, marks, registers, folds, and LSP actions.

How do I use nvim-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@nvim-mcp go to definition of the function under cursor" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

nvim-mcp

by paulburgess1357

Overview Schema Related Servers Score Discussions

Python

Local

nvim-mcp

PyPI

nvim-mcp is an MCP server that lets AI assistants (Cursor, Claude, and others) control a running Neovim session: open buffers, move the cursor, run LSP actions, inspect layout, and more. It talks to Neovim over its default socket via pynvim, discovers instances automatically, and exposes four tools.

Platforms: Linux and macOS only.

Install

uv tool install nvim-mcp

Or run without installing:

uvx nvim-mcp

Quick start

Start Neovim (it listens on an RPC socket by default).
Set up your MCP client and agent rules — see config/ for everything you need.
The assistant can now control Neovim through 4 tools.

Tools

Tool	Purpose
`nvim_send`	The universal interface. Send any ex command, Vimscript expression, or key sequence to Neovim. Three modes: `command`, `eval`, `keys`.
`nvim_state`	Structured snapshot: current file, cursor position, mode, window layout, modified buffers, cwd, and more.
`nvim_connect`	Connect to a Neovim instance. Auto-connects when only one exists; lists all when multiple are found.
`nvim_recipes`	Browse operation recipes by category (files, navigation, buffers, windows, marks, registers, folds, LSP).

Multi-instance

One Neovim instance running? Tools auto-connect. Multiple? nvim_connect lists them — pick by index, socket_path, or terminal_pid. Set NVIM_SOCKET_PATH to skip discovery entirely.

Setup

See config/ for MCP client registration (Cursor, Claude Desktop, Claude CLI) and example agent rule files.

Requirements

Python ≥ 3.10
Linux or macOS
Neovim with RPC socket enabled (default)

License

MIT — see LICENSE.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security
Open Source Has a Bot Problem
By punkpeye on March 19, 2026.
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/paulburgess1357/nvim-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server