Serena MCP
An MCP server that gives agents IDE powers: symbol and reference lookup, symbol-level edits and renames via LSP or JetBrains
- 30,849 ★ on the repository
- Last commit
Broad access
Why this level
- Edits project files
- Includes a shell command execution tool
Install
- Works in
Manual install
uv tool install -p 3.13 serena-agent
serena initRequires uv. For the JetBrains backend add -b JetBrains to serena init.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Edits project files
- Includes a shell command execution tool
This is third-party code. Review the repository files before installing.
What it does
Serena connects language servers to the agent and works with code at the symbol level rather than by lines. The agent can find a definition, every reference to a function, a file outline, replace a method body or insert code next to a symbol. The language server backend is free and covers dozens of languages. A paid JetBrains plugin adds moving files and symbols, inlining, type hierarchy and breakpoint debugging. It also has a memory system for long projects and flexible YAML configuration.
Who it is for. For developers who point agents at large codebases and want precise navigation and refactoring instead of text search.
Good fit when
- A large project where the agent gets lost with text search
- You need to rename a symbol across files without manual replace
- You need to find every usage of a function or class quickly
Not a fit when
- A small script or edits to prose and configs
- The project language has neither a language server nor JetBrains support
Example request
Find every call to calculate_total and rename it to compute_totalMCP
- Transport
- stdio, http
- Authentication
- not required
Limitations
Requires uv, and some languages need extra language server dependencies. Move, inline and debugging exist only in the paid JetBrains plugin, which does not support Rider or CLion. The authors ask not to install Serena from MCP or plugin marketplaces because their commands are outdated. The application is GPL-3.0 licensed.
How to disable. Run claude mcp remove serena or delete the serena entry from the client's MCP config, then run uv tool uninstall serena-agent.
FAQ
Do I need JetBrains?
No. Free language servers are used by default. The JetBrains plugin is only needed for advanced refactoring and debugging.
Will Serena duplicate Claude Code's built-in tools?
Its basic file and shell tools are disabled by default in Claude Code and Codex, leaving the semantic ones.
Discussion
No questions or reviews yet.
Related
MCP serversA bridge from an LSP language server to the agent: definitions, references, diagnostics, hover and symbol rename
An MCP server that indexes code with tree-sitter and returns individual functions and classes to the agent instead of whole files
An MCP server that builds a code graph of functions, classes, calls and routes and answers the agent's structural queries locally
An MCP server that exposes the cloud 1C:Napparnik (1C.ai) assistant and a local BSL Language Server to agents in Cursor and other IDEs
A local codebase index for agents: hybrid search, dependency graphs and change impact analysis
An MCP server and CLI for code research: search and understand your project and all of GitHub with fewer tokens
Comparison with similar tools
Entries that share the main search query, and how they differ.
| Entry | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Serena (this entry) | no | not required | 30,849 | |
| Code Index MCP | no | not required | 1,007 | an MCP server that indexes a local repository with tree-sitter and |
| cclsp | no | not required | 676 | cclsp connects LSP language servers to Claude Code over MCP |
| tilth | no | not required | 357 | a Rust binary for agents and the terminal that uses tree-sitter to |
README in short
The README calls Serena an IDE for the agent and describes two backends, language servers and a JetBrains plugin, with capability tables for each. Installation uses uv and serena init, and per-client setup lives in the docs. It warns that marketplace installs are outdated. Licensing is mixed: SolidLSP under MIT, the application under GPL-3.0.