serena: IDE-grade semantic tools for your coding agent

What it is

Serena is an open-source MCP server that gives coding agents IDE-grade code intelligence: symbol-aware search, reference tracking, and targeted edits that work on code structure rather than raw text. Under the hood it drives a standard language server (LSP), so support extends to over 40 languages without per-language setup.

When it actually helps

The payoff is clearest on large codebases. Instead of the agent reading file after file trying to locate where UserService is defined or what calls processPayment(), Serena gives it direct structural tools: find_symbol, get_references, get_outline. That cuts context burn and tends to produce more accurate edits, because the agent is working from the same index an IDE would use.

Symbolic editing is the other standout. Tools like replace_symbol_body and insert_before_symbol let the agent make surgical changes — swap just the method body, leave the signature alone — instead of the blunt read-file / write-file loop where something always drifts.

It integrates with Claude Code, Claude Desktop, Codex, Gemini CLI, Qwen3-Coder, and several others, so you are not locked to one client.

The honest caveat

The free setup (language server backend) covers symbol search, references, rename, and file tools — solid for most use. The more powerful operations — move symbol, propagate deletions, interactive debugger — require the JetBrains plugin backend, which is paid.

Startup is also not instant. LSP servers initialize once and then stay fast, but the first launch adds a few noticeable seconds. The README is also upfront about scope: if your task only touches a few small files, skip Serena — the overhead is real and the gain is marginal.

Getting started

Install with uv and initialize:

uv tool install -p 3.13 serena-agent
serena init

Then follow the client setup guide at oraios.github.io/serena to wire it into Claude Code or your agent of choice. The README specifically warns against installing through an MCP marketplace — go direct to avoid version drift.

Built by the oraios team. The core toolkit is GPL-3.0; the SolidLSP component is MIT. Source and full docs at github.com/oraios/serena.