Advertise
MCP.so
Sign In

Emacs MCP Server

@vivekhaldar

Repository

Basic information

Category

Other

Transports

stdio

Author

vivekhaldar

About Emacs MCP Server

No overview available yet

#emacs#mcp#elisp#server

Emacs MCP Server 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": ""
      }
    }
  }
}

Emacs MCP Server tools

2

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.

Frequently asked questions

1

What dependencies are required?

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

2

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

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K
N

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Advertise