iggredible avatar

Vim Mcp

iggredible/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 tools

Public 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:

  1. The MCP server starts a Unix socket server at /tmp/vim-mcp-server.sock
  2. Each Vim instance connects to the server as a Unix socket client
  3. Vim sends registration and state updates to the server
  4. The server maintains active connections to all Vim instances
  5. Claude Code communicates with the MCP server via Model Context Protocol

Demo

List and select Vim instance:

List and select Vim instances

You can (finally) exit Vim!

List and select Vim instances

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?


View the full README on GitHub

Details

Repository
github.com/iggredible/vim-mcp
Category
Search & Web Crawling
Package
vim-mcp
Transport
STDIO
Registry
MCP registry, active

Related Search & Web Crawling MCP servers

View all
1happygallo avatarApple Adshappygallo/apple-ads-mcpManage Apple Search Ads campaigns, keywords, budgets, and reports via API v5.3stars
2lipdog avatarFossicklipdog/fossick-mcpSearch all of GitHub from your AI agent — find libraries, drill into repos, find code patterns.3stars
3markswendsen-code avatarDeltamarkswendsen-code/mcp-deltaMCP server for Delta Airlines - search flights, check status, manage trips3stars
4ozanmutlu avatarGitlab Docsozanmutlu/gitlab-docs-mcpSearch and browse 2,900+ official GitLab documentation pages via MCP3stars
5trackly-app avatarTrackly CLItrackly-app/trackly-cliSearch Thousands of jobs, Thousands of companies. MCP for Claude, ChatGPT, Codex and Cursor.3stars
6linkmcp-io avatarLinkMCP: hosted LinkedIn MCP serverlinkmcp-io/linkmcpHosted LinkedIn MCP server on your own account: 35 tools for search, profiles, inbox, posts, pages.3stars