Menu

AI

Serena MCP Server: Tools, Setup and Security

Serena gives coding agents IDE-style symbol search, refactoring and editing over MCP, using language servers or a JetBrains plugin. See setup and risks.

By: Irina ShvayaNovember 2, 2026

Serena MCP Server: Tools, Setup and Security

This profile is part of our MCP server directory, within The MCP Guide. Profiles are checked against each vendor's own documentation. Need a server built? See MCP development.

Serena is an open-source MCP server that gives coding agents IDE-like tools. Instead of reading whole files and editing by line number, the agent can find symbols, follow references, rename and replace code at the symbol level. It runs locally and works with Claude Code, Codex, Cursor and other MCP clients.

Checked against: the Serena README on GitHub and Serena's client setup guide on 2 November 2026. eSEOspace did not install or test this server.

Key Takeaways

  • Serena uses language servers (free, the default) or a paid Serena JetBrains plugin to understand your code.
  • The README claims support for over 40 languages through language servers.
  • Install with uv tool install -p 3.13 serena-agent, then run serena init.
  • The README warns: "Do not install Serena via an MCP or plugin marketplace!" because those listings carry outdated commands.
  • Serena can run shell commands and edit code, so treat it as a write-capable local server.

At a glance

ItemDetail
PublisherOraios AI
Official?Yes (the project's own server)
HostingLocal
Transportstdio (launch command) or HTTP mode
Sign-inNone
Read or writeRead-write, including refactors and optional shell commands
PriceFree with language servers; JetBrains plugin is paid (free trial)
Source codeoraios/serena (GPL-3.0-or-later; SolidLSP part MIT)
StatusSerena v2 released

What it can do

The README lists these capability groups:

  • Retrieval: find symbol, file outline, find referencing symbols, find declaration, find implementations, diagnostics and querying external projects. Type hierarchy and dependency search need the JetBrains plugin.
  • Refactoring: rename symbols with language servers. Moving symbols, files and directories, inlining and propagating deletions need the JetBrains plugin.
  • Symbolic editing: replace a symbol's body, insert before or after a symbol, and safe delete.
  • Debugging: breakpoints, variable inspection and expression evaluation, available only through the JetBrains plugin.
  • Basic tools: search_for_pattern, replace_content, list_dir, find_file, read_file and execute_shell_command. The README says these are usually off by default inside harnesses such as Claude Code, which already provide similar tools.
  • Memory: a simple memory system for knowledge shared across sessions.

Serena v2 adds a REPL-based agent interface, which you choose in configuration. Active tools, prompts and modes are set in YAML at global, project and client levels.

How to connect it

Serena is managed by uv, which is the only prerequisite:

uv tool install -p 3.13 serena-agent
serena init

Add -b JetBrains to serena init to use the JetBrains backend instead.

For Claude Code, the setup guide offers automatic setup with serena setup claude-code, or a manual global command:

claude mcp add --scope user serena -- serena start-mcp-server --context claude-code --project-from-cwd

For Claude Desktop, add this under mcpServers:

{
  "mcpServers": {
    "serena": {
      "command": "serena",
      "args": ["start-mcp-server", "--context=desktop-app"]
    }
  }
}

The guide says to fully quit Claude Desktop through File, Exit, because closing the window only minimizes it. Other clients use their own contexts, such as codex, vscode or ide. If startup is slow in Claude Code, the guide suggests export MCP_TIMEOUT=60000.

Security notes

Serena edits real code and, when enabled, runs shell commands through execute_shell_command. Keep that tool off unless you need it, and review diffs as you would any agent change.

The setup guide describes an alpha auto-approve hook for Claude Code. It approves Serena calls whenever Claude Code is in acceptEdits or auto mode, which covers destructive tools such as replace_symbol_body and rename_symbol. Turn it on only if you accept that scope.

Other points:

  • Install source. Follow the README and use uv, not a marketplace listing.
  • Project scope. Per-project contexts with --project keep Serena focused on one codebase. Global setups need the activate_project tool.
  • HTTP mode. If you run Serena over HTTP, keep it on 127.0.0.1. See exposed local MCP servers.
  • License. The application is GPL-3.0-or-later, which matters if you plan to redistribute it.

The MCP project's security best practices cover local server compromise. Plan which tools to allow with the MCP tool permission planner, and see the MCP Security Center.

Alternatives

Next step

Try Serena on one large project and compare how many steps a cross-file rename takes with and without it. Our best MCP servers for developers list covers other coding tools, and the MCP server directory has more profiles.

More in the MCP Guide

Free tools: MCP Server Risk Checklist · Tool Permission Planner

Latest research: State of MCP: October 2026

Frequently asked questions

Is Serena free?

The core server with language servers is free and open source. The Serena JetBrains plugin is paid, with a free trial.

Which languages does Serena support?

The README says over 40 through language servers, including Python, TypeScript, Java, Go, Rust, C# and PHP. The JetBrains plugin supports what your JetBrains IDE supports, except Rider and CLion.

Why does Serena say not to install it from a marketplace?

The README says marketplace listings "contain outdated and suboptimal installation commands." It recommends installing with uv and following its client guide.

Does Serena work with Claude Code?

Yes. Serena has a claude-code context and an automatic serena setup claude-code command.

Get a FREE Website Audit

Enter your website and get a 20–30 page SEO, GEO, AEO & CRO audit within 24 hours. Completely free.

Don't have a site yet? Get in touch →

Ready to speak with a marketing expert?
Give us a call! (916) 866-7893

Websites Launched
1407
Websites Launched
Marketing Experts
29
Marketing Experts
Hours of Dedicated Work
204533
Hours of Dedicated Work
Irina S.Benjamin G.Jeanette M.David G.