emacs-mcp-server

emacs-mcp-server

4
os_automation

The Emacs MCP Server enables language models to interact with Emacs, evaluating Lisp expressions and retrieving contextual data. It supports operations like buffer manipulation and text retrieval through Emacs client commands.

Emacs MCP Server

This project is an MCP (Model Context Protocol) server that facilitates interaction between language models and Emacs through command evaluations. Key features include:

  • Evaluation of Emacs Lisp expressions.
  • Retrieval of text visible in the Emacs window.
  • Access to contextual information about the current Emacs state (such as buffer and mode).

Features

  • emacs_eval: Evaluates Emacs Lisp expressions.
  • emacs_get_visible_text: Retrieves visible text in Emacs.
  • emacs_get_context: Provides contextual information about Emacs state.

Requirements

  • Node.js
  • Emacs with server running (M-x server-start).

Installation

  • No installation needed if using npx. Ensure Node.js and npm are installed.

Usage

  • Can be configured with Claude for Desktop for usage.
  • Requires specifying the MCP server in Claude's configuration file.

How It Works

  • Utilizes emacsclient --eval for Lisp expression execution.
  • Enables command execution, text manipulation, and retrieving contextual information in Emacs.