Is Serena MCP free?
Yes. The Serena application is open source under GPL-3.0-or-later (its SolidLSP component is MIT), and the default language server backend is free. Only the optional JetBrains plugin is paid, with a free trial.
@oraios
Basic information
A powerful MCP toolkit for coding, providing semantic retrieval and editing capabilities - the IDE for your agent
Documentation reviewed 2026-10-25
Serena is useful for symbol-aware code navigation and editing. Its language-server or JetBrains backend provides code structure beyond plain text search.
The current upstream quick start installs serena-agent with uv, then runs serena init. It explicitly warns about outdated marketplace commands. Use the linked client guide and verify support for your programming language before copying an older configuration.
These notes check the linked documentation, not a live authenticated connection. Suggested checks are steps for you to run.
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"serena": {
"command": "uv",
"args": [
"tool",
"install",
"-p",
"3.13",
"serena-agent"
]
}
}
}Tool list not available yet
This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Serena MCP is an open-source coding agent toolkit from Oraios that gives AI agents IDE-like semantic code retrieval, editing, refactoring and debugging tools, working at the symbol level instead of line numbers or plain text search.
Serena connects to any MCP client, such as Claude Code, Codex, Cursor, VS Code or Claude Desktop. Its analysis comes from one of two backends: free, open-source language servers (LSP, the default, covering 40+ languages) or the paid Serena JetBrains Plugin, which uses your JetBrains IDE's own code analysis (free trial available). The project describes itself as "the IDE for your coding agent", and it pays off most in large, complex codebases.
The only prerequisite is uv. The maintainers advise against installing Serena through MCP or plugin marketplaces, which they say carry outdated install commands. Install and initialise it from your shell:
uv tool install -p 3.13 serena-agent
serena init
serena init sets up the language server backend by default. Add -b JetBrains to use the JetBrains plugin backend instead. Some languages need extra language-server dependencies (see the Language Support page in the docs).
The quickest route is serena setup claude-code. To add it by hand for all projects:
claude mcp add --scope user serena -- serena start-mcp-server --context claude-code --project-from-cwd
Or for the current project only:
claude mcp add serena -- serena start-mcp-server --context claude-code --project "$(pwd)"
Run /mcp to confirm the connection. If Serena starts too slowly, raise MCP_TIMEOUT (for example export MCP_TIMEOUT=60000). The docs also offer optional serena-hooks commands that remind the agent to use Serena's tools during long sessions.
Open File / Settings / Developer / MCP Servers / Edit Config and add:
{
"mcpServers": {
"serena": {
"command": "serena",
"args": ["start-mcp-server", "--context=desktop-app"]
}
}
}
Fully quit Claude Desktop (File / Exit) and reopen it.
Run MCP: Add Server, pick Command (stdio) and enter serena start-mcp-server --context=vscode (global) or serena start-mcp-server --context=vscode --project ${workspaceFolder} (workspace).
The docs have no Cursor-specific page. For MCP-enabled IDEs like Cursor, Windsurf, Cline and Roo Code, they suggest adding the serena start-mcp-server launch command with --context ide to reduce tool duplication.
Run serena setup codex, or add to ~/.codex/config.toml:
[mcp_servers.serena]
startup_timeout_sec = 15
command = "serena"
args = ["start-mcp-server", "--project-from-cwd", "--context=codex"]
AGENTS.md, or turned off.Only a subset of tools is active in any configuration, chosen mainly by the --context you start Serena with.
find_symbol, get_symbols_overview, find_referencing_symbols, find_declaration and find_implementations for navigation. replace_symbol_body, insert_after_symbol, insert_before_symbol, rename_symbol and safe_delete_symbol for edits. get_diagnostics_for_file returns diagnostics grouped by symbol.jet_brains_move, jet_brains_inline_symbol, jet_brains_type_hierarchy, jet_brains_run_inspections and jet_brains_debug.read_file, list_dir, find_file, search_for_pattern, replace_content and execute_shell_command. These are usually off inside harnesses like Claude Code that already have such tools.write_memory, read_memory, list_memories, edit_memory and delete_memory.activate_project, onboarding, initial_instructions and get_current_config.parse_config and summarise how each one handles errors."UserService.create to validate the email first."Serena's niche is semantic, symbol-aware code work. A general Filesystem MCP Server only reads and writes files, and documentation servers such as Context7 or DeepWiki supply library docs rather than editing your code. Within Serena, the free LSP backend covers navigation, symbolic edits and renames. The paid JetBrains plugin adds moves, inlining, type hierarchy and debugging.
serena command: use the full path to the serena executable in your MCP config.serena-hooks reminder hooks for Claude Code or VS Code, or prompt "Activate the current project with Serena and read initial instructions."MCP_TIMEOUT, for example to 60000.env block to the serena server entry.Yes. The Serena application is open source under GPL-3.0-or-later (its SolidLSP component is MIT), and the default language server backend is free. Only the optional JetBrains plugin is paid, with a free trial.
Oraios maintains Serena, with much of the language support contributed by the open-source community. The official repository is [oraios/serena](https://github.com/oraios/serena).
Yes. The docs give commands for Claude Code, VS Code, Codex, Claude Desktop, JetBrains assistants and others. Cursor uses the generic launch command, preferably with `--context ide`.
No. Serena runs locally and needs no API key. The LLM is provided by your MCP client.
With language servers, over 40 languages, including Python, Java, TypeScript, Go, Rust, C/C++, C#, PHP, Ruby and Kotlin. With the JetBrains plugin, any language your JetBrains IDE supports, except in Rider and CLion.
Yes. You can start the Serena MCP server yourself in HTTP mode and give your client the URL, instead of letting the client launch it over stdio.
Serena can run shell commands and modify files. Its security model assumes your machine, client, repository and configuration are trusted, and the maintainers say sandboxing is the only way to fully guard against unintended actions.
The README warns that marketplace listings contain outdated install commands. Use `uv tool install -p 3.13 serena-agent` and the client commands from the official docs instead.

Set up and manage the Eddyter AI rich text editor by talking to your AI agent — for Claude, Cursor, Codex and other MCP tools. A Model Context Protocol server that lets AI tools add Eddyter to a React, Next.js, Vite or R

Open-source Next.js + Supabase CMS with a per-site MCP server: scaffold a site, then create pages, posts, navigation, media and SEO from Claude, Cursor or any MCP client. Streamable HTTP with a bearer token you mint in y

Complete, hosted login, teams, billing and feature flags for your SaaS app, set up by your AI assistant: sign-in and SSO, customer teams and roles, plans and usage limits on Stripe, and feature flags. OAuth sign-in, no A

Agent-Native Terminal
Comments