Serena — IDE powers on the codebase, through language servers
Serena gives the agent what an IDE has over code. Everything goes through MCP.

What it does
Serena gives the agent what an IDE has over code. Everything goes through MCP.
Forget blind search and replace. It works with symbols. It finds declarations. It finds who calls a symbol. It renames. It changes the body of a symbol. It returns diagnostics per file.
Under all of that sit LSP language servers. That is the free option and the default.
On the LSP backend it covers more than 40 languages. From C/C++ and Rust to Zig and Wolfram.
What it does not do
Do not expect Serena to run code, find runtime bugs, or write full features for you. It works only with static symbols and whatever the language server gives it. In languages with dynamic dispatch, reflection, or generated code, the “who calls it” and refactor results can come back incomplete or wrong.
It does not replace a full IDE with debugging, profiling, or a test runner. It does not do semantic inference beyond LSP data. Where the language server is weak, rename and change-body break. If your project has tools or build steps that generate code later, you need manual indexing or a separate pipeline.
Do not ask it to keep state across large LLM sessions without the alpha hooks — Claude forgets tools if you do not set it up correctly. And if you plan to bind Serena into a closed product, ask a lawyer about GPL-3 before you move ahead.
Who it is for
For work on a real codebase. Cross-file rename, refactor, “who calls this.” Not for small text fixes.
Installation
The only thing you need is uv.
uv tool install -p 3.13 serena-agentIt downloads Serena and its executables.
serena initIt sets up the global config.
One note from the creator: do not take it from MCP or a plugin marketplace. Those sources give outdated commands.
Use with each LLM
Claude Code
The simplest path:
serena setup claude-codeIt sets up the connection on its own.
If you want it manually, for all projects:
claude mcp add --scope user serena -- serena start-mcp-server --context claude-code --project-from-cwdIt registers Serena as an MCP server.
The documentation also suggests hooks. They are alpha. Without them, Claude forgets Serena’s tools when the session gets long.
Codex CLI
serena setup codexOr manually in ~/.codex/config.toml.
One point: the Codex app does not open in the project folder. Tell it from the start to set the current folder as the project.
Cursor
It has no dedicated setup target. You set it up as an MCP server with the general config. Use –context ide so the tools do not overlap with Cursor’s own.
Where it wins, where it loses
It wins on depth. It works with symbols, not screenshots. You do not pay for vision you do not need.
It loses on license. The application is GPL-3.0-or-later. If you are building a closed product, ask a lawyer before you bind it.
And the quality depends on each language’s language server. Where the server is weak, rename breaks too.
The license needs care
Serena does not have one simple license. The repo is per-component. The SolidLSP core is MIT. The application is GPL-3.0-or-later. The LICENSE says it clearly: the serena-agent package combines both, so as a whole it goes under GPL.
That is not retroactive. v1.7.0 was the last one with MIT. From v2 it changes. The GitHub API shows it as NOASSERTION. The README badge and PyPI say MIT. Both are confusing.
Test
I installed it for real. On uv 0.12.15, Windows x86_64.
uv tool install -p 3.13 serena-agentIt passed without trouble. serena-agent 1.7.0. Three executables.
serena --versionIt returned Serena 1.7.0.
What I did not do: I did not run serena init, because it is interactive. I did not index a real project. What I write about behavior inside the agent comes from the documentation.
Verdict
The strongest tool in the category for work on a real codebase. It is not for small fixes. It is for cross-file rename, refactor, and “who calls this” — where the alternative is ten brittle steps.
Score: 8.5/10.
See also
If this helped, see also:
- ty: Astral’s type checker that catches the mistake before it runs
- cf: Cloudflare’s new CLI that does not guess flags
- ast-grep: grep that understands code, not text
Sources:
https://github.com/oraios/serena
https://github.com/oraios/serena/blob/main/LICENSE
https://oraios.github.io/serena/01-about/060_license.html
https://oraios.github.io/serena/02-usage/030_clients.html
https://oraios.github.io/serena/01-about/035_tools.html
Εγκατάσταση
1 ΒΗΜΑ- uv tool install -p 3.13 serena-agent