mcphub.nvim

An MCP client for Neovim that seamlessly integrates MCP servers into your editing workflow with an intuitive interface for managing, testing, and using MCP servers with your favorite chat plugins.

README.md

<div align="center" markdown="1"> <sup>Special thanks to:</sup> <br> <br> <a href="https://www.warp.dev/mcp-hub-nvim"> <img alt="Warp sponsorship" src="https://github.com/user-attachments/assets/fae9c70d-51de-43fa-af65-c82228ba67f9"> </a>

The Intelligent Terminal

Run mcphub.nvim in Warp today<br>

</div> <hr> <div align="center" markdown="1"> <h1> <img width="28px" style="display:inline;" src="https://github.com/user-attachments/assets/5cdf9d69-3de7-458b-a670-5153a97c544a"/> MCP HUB</h1>

</div>

MCP Hub is a MCP client for neovim that seamlessly integrates MCP (Model Context Protocol) servers into your editing workflow. It provides an intuitive interface for managing, testing, and using MCP servers with your favorite chat plugins.

💜 Sponsors

<p align="center"> <a href="https://github.com/CryogenicPlanet"><img src="https://github.com/CryogenicPlanet.png" width="50px" alt="CryogenicPlanet" /></a> <a href="https://github.com/olimorris"><img src="https://github.com/olimorris.png" width="50px" alt="Oli Morris" /></a> <a href="https://github.com/supermemoryai"><img src="https://github.com/supermemoryai.png" width="50px" alt="Super Memory" /></a> <a href="https://github.com/yingmanwumen"><img src="https://github.com/yingmanwumen.png" width="50px" alt="yingmanwumen" /></a> <a href="https://github.com/yetone"><img src="https://github.com/yetone.png" width="50px" alt="Yetone" /></a> <a href="https://github.com/omarcresp"><img src="https://github.com/omarcresp.png" width="50px" alt="omarcresp" /></a> <a href="https://github.com/petermoser"><img src="https://github.com/petermoser.png" width="50px" alt="petermoser" /></a> <a href="https://github.com/watsy0007"><img src="https://github.com/watsy0007.png" width="50px" alt="watsy0007" /></a> <a href="https://github.com/kohane27"><img src="https://github.com/kohane27.png" width="50px" alt="kohane27" /></a> <a href="https://github.com/copleykj"><img src="https://github.com/copleykj.png" width="50px" alt="Kelly Copley" /></a><a href="https://github.com/nom-social"><img src="https://github.com/nom-social.png" width="50px" alt="Nom Social" /></a></p> <p align="center"> <b>Special thanks to:</b> </p> <p align="center"> <a href="https://dub.sh/composio-mcp" target="_blank"> <img src="https://ravitemer.github.io/mcphub.nvim/sponsors/composio-logo.png" height="60px" alt="Composio.dev logo" /> </a> <a href="https://vapi.ai" target="_blank"> <img src="https://github.com/user-attachments/assets/32b4d458-b2d1-484d-b096-dfb083b44c2c" height="60px" alt="Vapi logo" /></a> </p>

✨ Features

Category	Feature	Support	Details
Capabilities
	Tools	✅	Full support
	🔔 Tool List Changed	✅	Real-time updates
	Resources	✅	Full support
	🔔 Resource List Changed	✅	Real-time updates
	Resource Templates	✅	URI templates
	Prompts	✅	Full support
	🔔 Prompts List Changed	✅	Real-time updates
	Roots	❌	Not supported
	Sampling	❌	Not supported
MCP Server Transports
	Streamable-HTTP	✅	Primary transport protocol for remote servers
	SSE	✅	Fallback transport for remote servers
	STDIO	✅	For local servers
Authentication for remote servers
	OAuth	✅	With PKCE flow
	Headers	✅	For API keys/tokens
Chat Integration
	Avante.nvim	✅	Tools, resources, resourceTemplates, prompts(as slash_commands)
	CodeCompanion.nvim	✅	Tools, resources, templates, prompts (as slash_commands), 🖼 image responses
	CopilotChat.nvim	✅	Tools, resources, function calling support
Marketplace
	Server Discovery	✅	Browse from verified MCP servers
	Installation	✅	Manual and auto install with AI
Configuration
	Universal `${}` Syntax	✅	Environment variables and command execution across all fields
	VS Code Compatibility	✅	Support for `servers` key, `${env:}`, `${input:}`, predefined variables
	JSON5 Support	✅	Comments and trailing commas via `lua-json5`
Workspace Management
	Project-Local Configs	✅	Automatic detection and merging with global config
Advanced
	Smart File-watching	✅	Smart updates with config file watching
	Multi-instance	✅	All neovim instances stay in sync
	Shutdown-delay	✅	Can run as systemd service with configure delay before stopping the hub
	Lua Native MCP Servers	✅	Write once , use everywhere. Can write tools, resources, prompts directly in lua
	Dev Mode	✅	Hot reload MCP servers on file changes for development

🎥 Demos

<div align="center"> <h4>MCP Hub + <a href="https://github.com/olimorris/codecompanion.nvim">CodeCompanion</a> + Github </h4> <p> <video muted controls src="https://github.com/user-attachments/assets/1a10ad50-5832-4627-bcc3-be49e7941105"></video> </p> </div> <div align="center"> <p> <h4>MCP Hub + <a href="https://github.com/yetone/avante.nvim">Avante</a> + Figma </h4> <video controls muted src="https://github.com/user-attachments/assets/e33fb5c3-7dbd-40b2-bec5-471a465c7f4d"></video> </p> </div>

🚀 Getting Started

Visit our documentation site for detailed guides and examples

👋 Get Help

Check out the Troubleshooting guide
Join our Discord server for discussions, help, and updates

:gift: Contributing

Please read the CONTRIBUTING.md guide.

🚧 TODO

👏 Acknowledgements

Thanks to:

nui.nvim for inspiring our text highlighting utilities
ravitemer/mcp-registry for providing the marketplace api

Stars1.8k

Installs0

Forks87

LanguageLua

AddedAug 4, 2026