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.