claude-code-emacs

Overview

Claude Code Emacs provides seamless integration between Emacs and Claude Code through the Model Context Protocol. It enables AI-powered coding sessions directly within Emacs with project isolation, smart file completion, and custom commands. The package offers deep integration with Emacs features including buffer operations, LSP diagnostics, and Git workflows, creating a powerful coding assistant environment. Its modular design ensures efficient real-time communication between Emacs and Claude Code through WebSocket connections.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• list_buffers

  List open buffers in Emacs

  Try:Show me all open buffersTry:List my current buffers
• read_buffer

  Read contents of an Emacs buffer

  Try:Show me the content of src/utils.jsTry:Read the contents of my main.el file
• get_selected_text

  Get currently selected text in Emacs

  Try:What text have I selected?Try:Show me the selected text
• get_diagnostics

  Get LSP diagnostics for current buffer

  Try:Show me all the errors in this fileTry:List diagnostics for my code
• find_definition

  Find definition of symbol using LSP

  Try:Find the definition of this functionTry:Where is this variable defined?
• find_references

  Find references to symbol using LSP

  Try:Find all references to this functionTry:Show me where this variable is used
• describe_symbol

  Get documentation for symbol using LSP

  Try:Describe this functionTry:Show me documentation for this class
• diff_files

  Compare two files showing differences

  Try:Compare version1.js and version2.jsTry:Show differences between these two files
• view_git_changes

  View git changes for current file

  Try:Show me uncommitted changesTry:What git changes exist for this file?
• apply_patch

  Apply patch to file

  Try:Apply this patch to my fileTry:Fix these changes in my code
• commit

  Create git commit

  Try:Commit my changes with message 'fix bug'Try:Create a git commit with these changes
• push

  Push changes to remote git repository

  Try:Push my commits to originTry:Upload my changes to GitHub

Note: Tool names inferred from MCP integration section and key features, as README doesn't provide explicit MCP tool documentation

Comparable tools

Installation

# Install MCP server globally
npm install -g claude-code-mcp-server

# Configure Claude Code to use MCP
claude mcp add-json emacs '{
  "type": "stdio",
  "command": "claude-code-mcp"
}'

# Add to Emacs init.el
(add-to-list 'load-path "/path/to/claude-code")
(require 'claude-code)
(global-set-key (kbd "C-c c") 'claude-code-transient)

FAQ

What Emacs versions are required?

Emacs 28.1 or later is required. Additional packages like projectile, vterm, transient, and markdown-mode are needed. LSP-mode (9.0.0+) is optional but recommended for full functionality.

How does the MCP server communicate with Emacs?

The server uses stdio communication with Claude Code and maintains a separate WebSocket connection for each project. This enables real-time event batching and automatic reconnection with health monitoring.

Compare claude-code-emacs with