---
title: "Serena MCP: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/mcp-servers/serena/
description: "Gives coding assistants symbol-aware navigation, editing and refactoring through language-server or JetBrains backends."
---

# Serena MCP: review, setup & limitations · Undominated.ai

> Gives coding assistants symbol-aware navigation, editing and refactoring through language-server or JetBrains backends.

[← Explore all mcp servers](/mcp-servers/)

SEMANTIC CODE TOOLS / Oraios

# Serena MCP

Gives coding assistants symbol-aware navigation, editing and refactoring through language-server or JetBrains backends.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/oraios/serena)

SOURCE REVIEW

 Reviewed 2026-10-13
 Evidence 4 linked sources
 Publisher Oraios
 Licence [GPL-3.0-or-later ↗](https://github.com/oraios/serena/blob/f9972a32c67359dd4c4a5ab597688bb10d21d1f3/LICENSE)
 Revision f9972a32c673
 [Read what was—and wasn’t—checked ↓](#review)

“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 relational structure.”

 [Oraios · upstream description ↗](https://github.com/oraios/serena/blob/f9972a32c67359dd4c4a5ab597688bb10d21d1f3/README.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - Offers project-aware semantic operations instead of relying entirely on text search and line offsets.
- Tool registration marks edit-capable operations as destructive, exposing a useful permission distinction.

### A good fit for

 - Navigating and modifying symbols across a larger codebase with supported language tooling.
- Moving, inlining or renaming files and directories inside a JetBrains IDE, which the README lists as JetBrains-plugin-only refactorings.

### Weigh up before choosing

 - Language support may require extra language-server dependencies; the JetBrains backend is a separate paid plugin.
- The application is GPL-3.0-or-later; only the SolidLSP component (src/solidlsp) remains MIT. The LICENSE file says Serena was MIT up to v1.7.0 and is GPL-3.0-or-later from v2.
- The basic utility tools include execute_shell_command, which runs shell commands. The README says these utilities are typically disabled by default inside harnesses such as Claude Code or Codex; elsewhere check which tools are active.
- The README warns against installing Serena from an MCP or plugin marketplace, saying those carry outdated installation commands.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - README.md at f9972a32c67359dd4c4a5ab597688bb10d21d1f3 (quick start, features, licence sections)
- pyproject.toml at f9972a32c67359dd4c4a5ab597688bb10d21d1f3
- src/serena/mcp.py at f9972a32c67359dd4c4a5ab597688bb10d21d1f3
- LICENSE at f9972a32c67359dd4c4a5ab597688bb10d21d1f3

### Our findings

 - The MCP entrypoint (src/serena/mcp.py) accepts the transports stdio, sse and streamable-http, and sets read_only_hint and destructive_hint on each tool from its can_edit() result.
- The quick start installs serena-agent with uv, runs serena init (language-server backend by default, -b JetBrains for the plugin), then links to client-specific launch guidance; the README itself has no client configuration block.
- The README lists the basic utilities search_for_pattern, replace_content, list_dir, find_file, read_file and execute_shell_command alongside the symbol-level retrieval, refactoring and editing tools.
- At this commit the README announces Serena v2 with a REPL-based agent interface; pyproject.toml names the package serena-agent, version 2.0.1.dev0, licence GPL-3.0-or-later.

### Not established by this review

 - Server startup, authentication and tool execution were not tested.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Connect a server deliberately.

[Upstream setup instructions ↗](https://github.com/oraios/serena/blob/f9972a32c67359dd4c4a5ab597688bb10d21d1f3/README.md)

DOCUMENTED COMMAND

 uv tool install -p 3.13 serena-agent Copy command ↗

Copying does not execute this command. It may retrieve a newer version than the reviewed source.

 - Run the documented serena init step after installation; add -b JetBrains to use the JetBrains plugin backend instead of language servers.
- Choose the supported backend and follow the linked client configuration guide for the MCP launch command.

### Before you start

 - uv and any language-server dependencies required by the project’s languages.

### Compatibility

An MCP client supporting stdio, SSE, Streamable HTTP. · uv and any language-server dependencies required by the project’s languages.

### Implementation

Python

### Transports

stdio · SSE · Streamable HTTP

### Semantic code tools / Configured credentials or local access

 - Reads and edits project source through symbol-level tools; edit-capable tools are annotated as destructive.
- Enabled utility tools can read files, replace content and execute shell commands.
- The JetBrains backend needs the paid Serena JetBrains plugin (the README says a free trial is available).

### Cost model

Local compute applies; the optional JetBrains backend has separate commercial terms.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [Official documentation ↗](https://github.com/oraios/serena/blob/f9972a32c67359dd4c4a5ab597688bb10d21d1f3/README.md) Checked 2026-10-13 https://github.com/oraios/serena/blob/f9972a32c67359dd4c4a5ab597688bb10d21d1f3/README.md Supports: summary, upstreamDescription, whySelected, bestFor, limitations, install, access, compatibility, transports
- [Applicable source licence ↗](https://github.com/oraios/serena/blob/f9972a32c67359dd4c4a5ab597688bb10d21d1f3/LICENSE) Checked 2026-10-13 https://github.com/oraios/serena/blob/f9972a32c67359dd4c4a5ab597688bb10d21d1f3/LICENSE Supports: license, limitations
- [Implementation: pyproject.toml ↗](https://github.com/oraios/serena/blob/f9972a32c67359dd4c4a5ab597688bb10d21d1f3/pyproject.toml) Checked 2026-10-13 https://github.com/oraios/serena/blob/f9972a32c67359dd4c4a5ab597688bb10d21d1f3/pyproject.toml Supports: language, review
- [Implementation: src/serena/mcp.py ↗](https://github.com/oraios/serena/blob/f9972a32c67359dd4c4a5ab597688bb10d21d1f3/src/serena/mcp.py) Checked 2026-10-13 https://github.com/oraios/serena/blob/f9972a32c67359dd4c4a5ab597688bb10d21d1f3/src/serena/mcp.py Supports: language, review

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Claude Context MCP ↗ Indexes a local codebase into Milvus or Zilliz Cloud with a chosen embedding provider, then serves hybrid keyword and vector code search to an MCP client.](/mcp-servers/claude-context/)[### AWS IaC MCP Server ↗ Validates CloudFormation templates, retrieves CDK/CloudFormation guidance and investigates failed deployments.](/mcp-servers/aws-iac/)[### AWS Labs OpenAPI MCP ↗ Pins the OpenAPI MCP server that builds tools from an operator-supplied spec and names stdio as the transport.](/mcp-servers/awslabs-openapi/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Inspect resource evidence](/tools/)
- [Choose a host](/agents/)
- [Inspect reusable workflows](/skills/)
- [Use Undominated data](/api/)
