
Vim Mcp
This brings Vim and Neovim directly into Claude's context by standing up a Unix socket server that your editor instances connect to as clients. You get tools to list and select running Vim sessions, execute ex commands, query state like buffers and cursor position, search help docs semantically, and even record macros. The real use case is offloading complex operations you can describe but don't want to construct manually, like conditional regex substitutions across markdown headers or intricate macro sequences. Commands run through the MCP get stored in Vim's command history, so you can tweak and rerun them. It's for moments when explaining what you want takes fewer keystrokes than trial and error with Vim's syntax.
- GitHub stars
- 3
- tools
- 7
- transport
- STDIO
- last updated
- Sep 26, 2025
Tools
7 toolsPublic tool metadata for what this MCP can expose to an agent.
list_vim_instances
No parameter schema in public metadata yet.
select_vim_instance
No parameter schema in public metadata yet.
get_vim_state
No parameter schema in public metadata yet.
vim_execute
No parameter schema in public metadata yet.
exit_vim
No parameter schema in public metadata yet.
vim_search_help
No parameter schema in public metadata yet.
vim_record_macro
No parameter schema in public metadata yet.
Sponsors
Readme
vim-mcp
Simple MCP (Model Context Protocol) integration for Vim and Claude Code.
Features
- Connect Claude Code to one of your Vim instances
- Query Vim state (buffers, windows, cursor position, etc.)
- Execute Vim commands from Claude using natural language
How it works:
- The MCP server starts a Unix socket server at
/tmp/vim-mcp-server.sock - Each Vim instance connects to the server as a Unix socket client
- Vim sends registration and state updates to the server
- The server maintains active connections to all Vim instances
- Claude Code communicates with the MCP server via Model Context Protocol
Demo
List and select Vim instance:
You can (finally) exit Vim!
For more, check out the demo wiki page
Why would anyone need this?
Ok, I get what it does, but why do we need this?
Details
- Repository
- github.com/iggredible/vim-mcp
- Category
- Search & Web Crawling
- Package
vim-mcp- Transport
- STDIO
- Registry
- MCP registry, active