eval-elisp
Executes an arbitrary Elisp expression in the running Emacs process and returns the printed result. The expression passes through the security layer, which blocks dangerous functions and credential-bearing files (see Security).
How to use it
eval-elisp is exposed by the Emacs MCP Server MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the eval-elisp tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.
Install Emacs MCP Server
claude mcp add emacs -- socat - UNIX-CONNECT:$HOME/.config/emacs/.local/cache/emacs-mcp-server.sock # Uses socat directlyOther tools in Emacs MCP Server (17)
string
string
Retrieves errors and warnings from flycheck or flymake (auto-detected per buffer) across all project buffers. Results are grouped by file and sorted by severity.
structured agenda and TODO views.
archive a heading to its configured archive target.
create a new entry; template mode respects the user's
clock in, out, or cancel.
fetch a heading or file body.
enumerate existing tags with usage counts so the LLM can
enumerate the user's capture templates so the LLM
move a heading under another.
create a new node, respecting
fetch a node with its backlinks.
find nodes by title, alias, tag, or ref.
heading search using org's match syntax ("+work-home/!TODO" etc.).
update title, TODO state, priority, tags, properties,
string