serena logo

serena

oraios/serena

A powerful MCP toolkit for coding, providing semantic retrieval and editing capabilities - the IDE for your agent

GraphCanon updated today · GitHub synced today · 36 views this month

28k stars1.9k forksLast push 1d Python MIT

Decision brief

Serena is an advanced tool aimed at enhancing coding tasks through semantic retrieval and editing capabilities, designed for integration with AI agents.

Good fit when

  • You are working within a JetBrains IDE and want to leverage Serena's integrated tools for better code understanding and manipulation.
  • Your development workflow depends significantly on connecting to multi-coded platforms (MCPs) like Claude Code or Codex, requiring the flexibility of Serena’s backend configurations.

Avoid when

  • If your preferred IDE is not JetBrains, as other integrations may require more manual configuration and might not be fully supported.
  • You are looking for a generic code editor enhancement tool that does not need to interface with specific AI agents or MCP clients.

Observed Jul 11, 2026 · Source: enrich:decision_facts

Verify the decision

Maintenance and security

Full trust report
Maintenance
Very active (0d since push)
As of today
Provenance
Not a fork · Organization account
As of today
Security (OSV)
1 medium (1 medium)
As of 1mo

Public GitHub metadata and optional OSV scans. Signals, not a guarantee. Trust methodology.

Install

pip install serena
PyPI

How it fits your stack(7)

Typed graph edges - alternatives, integrations, successors, and dependencies. Ranked by relationship type, not raw GitHub stars.

Relationship graph

Optional deeper exploration of typed edges and category neighbours.

Similar tools

Same-category neighbours not already linked as typed edges.

Evidence and technical details

Sourced facts, taxonomy, compatibility claims, README excerpt, and machine-readable endpoints.

Overview

Serena is a tool designed to assist AI agents in coding tasks by offering features such as semantic retrieval and code editing. It can be integrated into various development environments including JetBrains IDEs.

Capability facts

Deploy
Self-host

Source: dockerfile:Dockerfile · Aug 19, 2026

Docker
Dockerfile present

Source: dockerfile:Dockerfile · Aug 19, 2026

CLI
CLI entrypoint

Source: pyproject.toml:[project.scripts] · Aug 19, 2026

MCP server
No MCP server detected

Source: repo_scan · Aug 19, 2026

Languages
python

Source: github.language+pyproject.toml · Aug 19, 2026

Categories

Compatibility

Sourced claims from the README excerpt - not unsourced marketing copy.

Works with Claude DesktopClaude Desktop

Source: README excerpt (regex_v1, Aug 19, 2026)

link for specific instructions on how to set up Serena for Claude Code, Codex, Claude Desktop, MCP-enabled IDEs and other clients (such as local and web-based GUIs).
Source link
Works with JetBrains IDEsJetBrains IDEs

Source: README excerpt (regex_v1, Aug 19, 2026)

default, this will set up Serena to use the language server backend. To use the JetBrains backend instead, add the parameters `-b JetBrains`
Source link

Tags

README

Quick Start

Prerequisites. Serena is managed by uv, and installing uv is the only required prerequisite.

[!NOTE] When using the language server backend, some additional dependencies may need to be installed to support certain languages; see the Language Support page for details.

Install Serena. Serena is installed via uv as follows:

uv tool install -p 3.13 serena-agent

After successful installation, the command serena should be available in your shell.

Initialise Serena. To initialise Serena and verify that your setup works correctly, simply run:

serena init

By default, this will set up Serena to use the language server backend. To use the JetBrains backend instead, add the parameters -b JetBrains (see the JetBrains Plugin documentation page for additional usage details).
Either way, you should receive a success message indicating that Serena has been initialised successfully.

Configuring Your Client. To connect Serena to your preferred MCP client, you typically need to configure a launch command in your client. Follow the link for specific instructions on how to set up Serena for Claude Code, Codex, Claude Desktop, MCP-enabled IDEs and other clients (such as local and web-based GUIs).

[!TIP] While getting started quickly is easy, Serena is a powerful toolkit with many configuration options. We highly recommend reading through the user guide to get the most out of Serena.

Specifically, we recommend to read about ...

For agents

This page has a .md twin and JSON over the API.

Was this helpful?

Anonymous feedback helps us improve pages and translations.