Emacs MCP Server

@vivekhaldar

About Emacs MCP Server

No overview available yet

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

Frequently asked questions

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

Basic information

More Other MCP servers

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3

AutoBrowser MCP

autobrowser-ai

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K