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

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

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

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

P

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct

Advertise