Emacs MCP Tools
Provides tools for interacting with Git repositories through Emacs' Magit interface, allowing users to open git changes and perform repository management.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Emacs MCP Toolsopen file README.md in Emacs"
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.
Emacs MCP Tools
Direct MCP tools that allow Claude Code to communicate with and control a running Emacs instance using the Model Context Protocol.
Features
Open specified files in Emacs buffers
Open git changes in Magit
Check Emacs server status
List available tools
Modern MCP SDK integration using direct tools approach
Complementary to git-mcp for repository access
Related MCP server: VS Claude
Installation
You can install this package via npm:
# Global installation (recommended)
npm install -g emacs-mcp-server
# Local installation
npm install emacs-mcp-serverSetup with Claude Code
Once installed, you can add the MCP tools to Claude Code:
# Register tools with Claude Code
claude mcp add emacs-mcp-open emacs-mcp-open
claude mcp add emacs-mcp-magit emacs-mcp-magit
claude mcp add emacs-mcp-check emacs-mcp-check
claude mcp add emacs-mcp-list emacs-mcp-listManual Setup (Development)
For development or manual setup:
# Clone the repository
git clone https://github.com/toastynerd/emacs-mcp-server.git
cd emacs-mcp-server
# Install dependencies
npm install
# Add direct tools to Claude Code
claude mcp add emacs-mcp-open ./src/direct-tool.js
claude mcp add emacs-mcp-magit ./src/direct-tool.js
claude mcp add emacs-mcp-check ./src/direct-tool.js
claude mcp add emacs-mcp-list ./src/direct-tool.jsAdding Git MCP (Recommended)
For better repository exploration and documentation access, add git-mcp:
# Add git-mcp to Claude Code
claude mcp add --transport sse git-mcp https://gitmcp.io/idosal/git-mcpThis allows Claude to access repository documentation and code context through the Model Context Protocol.
Usage
After installation, you can use the MCP tools with Claude Code:
/mcp emacs-mcp-open file_path="/path/to/your/file.txt"
/mcp emacs-mcp-magit repo_path="/path/to/your/repo"
/mcp emacs-mcp-check
/mcp emacs-mcp-listFor more details, see CLAUDE.md.
Development
# Run unit tests
npm testRequirements
Node.js (v16+)
npm (v6+)
Emacs with server mode enabled (
M-x server-start)Magit (for Git functionality)
Claude Code CLI
License
MIT
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
This server cannot be deployed
Maintenance
Related MCP Connectors
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
Hosted MCP server connecting claude.ai, ChatGPT and other AI apps to your own computer
Use AI models for chat, image, and video generation from Claude Code and other MCP hosts.
The OpenRouter MCP server plugs OpenRouter into the AI tools you already use. Once connected, your assistant can pull live OpenRouter data (models, prices, your credits, rankings, and docs) and send quick test messages, all without leaving your editor.
Related MCP Servers
- AlicenseAqualityBmaintenanceAllows Claude desktop app to execute terminal commands and edit files on your computer through MCP, with features including command execution, process management, and diff-based file editing.26156,453 npm9,596MIT
- AlicenseNot gradedqualityFmaintenanceMCP server that integrates with VS Code to enable file operations, git diffs, and line highlighting via MCP clients like Claude.41MIT
- FlicenseBqualityDmaintenanceAn MCP server that bridges Claude Code with Emacs via emacsclient, enabling buffer, file, org-mode, git, and diff operations.55-
- FlicenseAqualityBmaintenanceAn MCP server that enables Claude to manage Emacs org-mode task lists, journal entries, and projects with token-efficient tools and visual approval via Emacs ediff.193-