Verified project record

oraios/serena

Serena provides semantic code retrieval, editing, refactoring, and debugging tools through an MCP server, enabling AI coding agents to navigate and modify code at the symbol level. It requires an LLM to orchestrate tool usage and relies on LSP or a JetBrains plugin for backend code analysis.

Project overview

Project type: MCP · AI Agent · AI Coding
Use cases: Coding & Development
Deployment: Refer to project documentation
License: MIT

Best for

Developer and AI engineer audiences configuring AI coding agents that require symbol-level navigation and manipulation in complex codebases.
Projects that require long-lived agent memory for knowledge sharing across sessions, users, and projects.

Key capabilities

Allows agents to explore codebases at the symbol level, finding symbols, references, and declarations without reading entire files.
Provides precise cross-file refactoring tools like rename, move, and inline to prevent unreliable search and replace operations.
Enables less error-prone, token-efficient editing of code by replacing symbol bodies and inserting code around symbols.
Maintains long-lived agent memory for knowledge sharing across sessions, users, and projects.
Allows an agent to set breakpoints, inspect variables, evaluate expressions and control execution flow via a persistent REPL-style interface.
Uses LSP to provide free/open-source symbolic code analysis capabilities for over 40 programming languages.
Leverages a paid plugin to use JetBrains IDE's code analysis, refactoring, and debugging capabilities.

Limitations and risks

The language server backend lacks some refactoring tools like move, inline, and propagate deletions which are exclusive to the JetBrains plugin.
Language servers may not work for declarations in external dependencies.
Installing Serena via an MCP or plugin marketplace may result in using outdated and suboptimal installation commands.

Getting started

Setup requires a single prerequisite (uv). Run 'uv tool install -p 3.13 serena-agent' and then 'serena init' to start.

Evidence and sources

README: The IDE for Your Coding Agent
README: Serena provides essential semantic code retrieval, editing, refactoring and debugging tools that are akin to an IDE's capabilities, operating at the symbol level and exploiting re…
README: It integrates with any client/LLM via the model context protocol (MCP).
README: Practically, this means that your agent operates faster, more efficiently and more reliably, especially in larger and more complex codebases.
README: Language servers implementing the language server protocol (LSP) — the free/open-source alternative which is used by default.

Reviewed at: 2026-07-17T10:44:18Z