Serena MCP: the IDE for your agent
Rank #41io.github.oraios/serena
A powerful toolkit for coding, providing semantic retrieval and editing capabilities.
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.
- 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
What Serena MCP: the IDE for your agent can and cannot do
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.
- search_for_pattern
- replace_content
- list_dir
- find_file
- read_file
- execute_shell_command
- 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
What you need before using Serena MCP: the IDE for your agent
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
Connect Serena MCP: the IDE for your agent and confirm it works
- Install uv
- Run uv tool install -p 3.13 serena-agent and confirm the serena command exists
- Run serena init (add -b JetBrains for the JetBrains backend)
- Point your MCP client at the launch command, or run the server in HTTP mode and give the client its URL
claude mcp add serena -- uvx -p 3.13 start-mcp-server --project-from-cwd --context desktop-app serena-agent[mcp_servers.serena]
command = "uvx"
args = ["-p", "3.13", "start-mcp-server", "--project-from-cwd", "--context", "desktop-app", "serena-agent"]Add to ~/.codex/config.toml.
{
"mcpServers": {
"serena": {
"command": "uvx",
"args": [
"-p",
"3.13",
"start-mcp-server",
"--project-from-cwd",
"--context",
"desktop-app",
"serena-agent"
]
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config).
{
"mcpServers": {
"serena": {
"command": "uvx",
"args": [
"-p",
"3.13",
"start-mcp-server",
"--project-from-cwd",
"--context",
"desktop-app",
"serena-agent"
]
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project).
{
"servers": {
"serena": {
"type": "stdio",
"command": "uvx",
"args": [
"-p",
"3.13",
"start-mcp-server",
"--project-from-cwd",
"--context",
"desktop-app",
"serena-agent"
]
}
}
}Save as .vscode/mcp.json in your workspace.
{
"mcpServers": {
"serena": {
"command": "uvx",
"args": [
"-p",
"3.13",
"start-mcp-server",
"--project-from-cwd",
"--context",
"desktop-app",
"serena-agent"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
{
"mcpServers": {
"serena": {
"command": "uvx",
"args": [
"-p",
"3.13",
"start-mcp-server",
"--project-from-cwd",
"--context",
"desktop-app",
"serena-agent"
]
}
}
}Run serena init in your project.
Expected: A success message confirming the setup, after which the client lists Serena's symbol tools.
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.
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
- Glama ↗listed since Apr 26, 2026 · still listed
- PulseMCP ↗listed since Jun 4, 2026 · still listed
- mcp.so ↗listed since Jun 4, 2026 · still listed
- Official MCP ↗listed since Jul 24, 2026 · still listed
Do you maintain Serena MCP: the IDE for your agent? to correct or enrich this profile.
Available versions (1)
| Version | Published |
|---|---|
| 1.5.3 | May 26, 2026 |
Ranks ahead of 144,355 of 144,396 servers on MCP Toplist.
Show your rank
Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.
[](https://mcptoplist.com/server/io.github.oraios%2Fserena)<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.
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.
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.