SERVER

Serena MCP: the IDE for your agent

Rank #41

io.github.oraios/serena

A powerful toolkit for coding, providing semantic retrieval and editing capabilities.

1 version
30,236 GitHub stars
by oraios (1 servers)View repository ↗
First listed
Apr 1, 2025
Last publish date
May 26, 2026
PURPOSE

What you can do with Serena MCP: the IDE for your agent

Serena gives coding agents IDE-like semantic tools: symbol-level code retrieval, editing and refactoring backed by language servers (or a JetBrains IDE), so the agent works with symbols and references instead of grepping whole files.

Suitable tasks
  • Find symbols, file outlines and references
  • Replace a symbol body or insert code around it
  • Rename a symbol across files
  • Run builds, tests and linters from the agent
  • Keep project knowledge in memories across sessions
CAPABILITIES AND LIMITATIONS

What Serena MCP: the IDE for your agent can and cannot do

Capabilities

Retrieval, symbolic editing and refactoring tools over 40+ languages via language servers, plus basic file, search and shell tools that are typically disabled inside harnesses that already have them. A JetBrains backend adds move, inline, safe delete, dependency search, type hierarchy and interactive debugging.

Documented tools
  • search_for_pattern
  • replace_content
  • list_dir
  • find_file
  • read_file
  • execute_shell_command
Limitations
  • Language-server backend has no move, inline or propagate-deletions; rename covers symbols only
  • Find declaration generally fails for external dependencies; find implementations only for some languages
  • Debugging, dependency search and type hierarchy need the paid JetBrains plugin (trial available); Rider and CLion are unsupported
  • Do not install from MCP or plugin marketplaces; the README calls those commands outdated
  • Some languages need extra language-server dependencies installed
REQUIREMENTS

What you need before using Serena MCP: the IDE for your agent

DeclaredNo credentialsNo credentials declared

The registry listing declares no required environment variables or authentication. This is declared metadata, not a verified install — the repository README is the authority.

Declared by Glama, last synced Oct 16, 2026. Not independently verified by MCP Toplist.

Runtime
uv with Python 3.13 (uv tool install -p 3.13 serena-agent)
Credentials
None
Payment
Free; the optional JetBrains plugin backend is paid
Also needed
Language servers for your languages, or a JetBrains IDE for the JetBrains backend
INSTALLATION AND FIRST TASK

Connect Serena MCP: the IDE for your agent and confirm it works

  1. Install uv
  2. Run uv tool install -p 3.13 serena-agent and confirm the serena command exists
  3. Run serena init (add -b JetBrains for the JetBrains backend)
  4. Point your MCP client at the launch command, or run the server in HTTP mode and give the client its URL
Python package (PyPI)
claude mcp add serena -- uvx -p 3.13 start-mcp-server --project-from-cwd --context desktop-app serena-agent
First successful task

Run serena init in your project.

Expected: A success message confirming the setup, after which the client lists Serena's symbol tools.

ALTERNATIVES

When to choose another server

  • MCP Language Server#3,451

    You want a thin wrapper around a single language server with fewer tools.

  • mcp-jetbrains#3,136

    You already work in a JetBrains IDE and want its own MCP bridge.

MAINTENANCE AND EVIDENCE

What changed, and when this was checked

First listed
Apr 1, 2025
Latest version published
May 26, 2026
Version history
1 version tracked (below)
Requirements evidence
Declared by Glama, last synced Oct 16, 2026. Not independently verified by MCP Toplist.
Profile checked
Oct 9, 2026 against README
Ranking data as of
Oct 16, 2026
Registry sightings

Do you maintain Serena MCP: the IDE for your agent? to correct or enrich this profile.

VERSIONS

Available versions (1)

VersionPublished
1.5.3May 26, 2026
STANDING
#41of 144,396 active serversTop 0.1%

Ranks ahead of 144,355 of 144,396 servers on MCP Toplist.

Recent momentum
+6,493GitHub stars since Apr 27 (+27%)
BADGE

Show your rank

Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.

MCP Toplist: Top 1% of 144,396
Markdown
[![MCP Toplist](https://mcptoplist.com/badge/io.github.oraios%2Fserena.svg)](https://mcptoplist.com/server/io.github.oraios%2Fserena)
HTML
<a href="https://mcptoplist.com/server/io.github.oraios%2Fserena"><img src="https://mcptoplist.com/badge/io.github.oraios%2Fserena.svg" alt="MCP Toplist: Top 1% of 144,396" /></a>

Variants: append ?metric=score or ?metric=stars to the image URL.

FAQ

Frequently asked questions

Who maintains Serena MCP: the IDE for your agent?
Serena MCP: the IDE for your agent is maintained by oraios, which publishes 1 MCP server (1 total version) tracked on MCP Toplist.
Is Serena MCP: the IDE for your agent listed on the Official MCP Registry?
Yes — Serena MCP: the IDE for your agent is listed on the Official MCP Registry, alongside Glama, PulseMCP and mcp.so.
How many versions does Serena MCP: the IDE for your agent have?
MCP Toplist tracks 1 version of Serena MCP: the IDE for your agent, most recently published on May 26, 2026.
Where can I find the source code for Serena MCP: the IDE for your agent?
The source code for Serena MCP: the IDE for your agent is hosted at github.com/oraios/serena.
Used in projects

Do you run this server?

Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.

EXPLORE