get-diagnostics
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.
How to use it
get-diagnostics is exposed by the Emacs MCP Server MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the get-diagnostics 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)
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).
string
string
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