Emacs MCP Server

Name: Emacs MCP Server
Author: vivekhaldar

@vivekhaldar

Repository

About Emacs MCP Server

No overview available yet

#emacs #mcp #elisp #server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "Emacs-MCP-Server": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "smartfunc",
        "mcp",
        "run",
        "/Users/haldar/repos/gh/emacs-mcp-server/emacs_mcp_server.py"
      ],
      "env": {
        "OPENAI_API_KEY": "",
        "EMACSCLIENT": ""
      }
    }
  }
}

Tools

generates elisp for a given task

passes elisp to a running Emacs (via `emacsclient`) to eval and execute it.

Overview

What is Emacs MCP Server?

A Model Context Protocol (MCP) server that integrates LLMs with Emacs by generating and executing Emacs Lisp code. It uses emacsclient to communicate with a running Emacs process. Designed for users who want to combine AI-based code generation with Emacs workflows.

How to use Emacs MCP Server?

The project is managed with uv. Run uv sync to install dependencies and source .venv/bin/activate to activate the virtual environment. To run the server in the MCP inspector, use mcp dev emacs_mcp_server.py. For integration with Claude Desktop, run mcp install emacs_mcp_server.py and then edit claude_desktop_config.json to include your OPENAI_API_KEY and the full path to emacsclient.

Key features of Emacs MCP Server

Generates Emacs Lisp code for a given task.
Executes generated elisp in a running Emacs via emacsclient.
Exposes two tools: generate_emacs_lisp_code and execute_emacs_lisp_code.
Requires an OpenAI API key and a configured emacsclient path.
Can be integrated with Claude Desktop or other MCP-compatible clients.

Use cases of Emacs MCP Server

Generate elisp code to automate repetitive Emacs actions (e.g., buffer operations).
Execute AI-generated elisp directly in an active Emacs session.
Quickly prototype and test Emacs Lisp functions with LLM assistance.

FAQ from Emacs MCP Server

What dependencies are required?

You need Python with uv, the mcp and smartfunc packages, a running Emacs, and emacsclient installed and accessible.

How do I install the server for Claude Desktop?

Run mcp install emacs_mcp_server.py, then edit the generated `claude_desktop_config.json

Comments

More Other MCP servers

XcodeBuildMCP

cameroncooke

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

6.0K

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K