serena

name	serena
description	Code editing and project management via Serena MCP. Use when user needs to read/write files, find/rename symbols, run shell commands, or manage project memory.
source_version	1.26.0
source_cli_hash	bc6b949c
generated_at	2026-04-06T08:49:26.537103+00:00

serena (via mcp2cli)

Code-aware editing, symbol navigation, memory, and project management.

Shortcuts

No shortcuts configured. Use mcp2cli serena <group> <cmd>.

Commands

File

Command	Description	Example	Ref
mcp2cli serena file create	Create or overwrite a text file	mcp2cli serena file create --relative-path src/new.py --content 'print("hi")'	ref
mcp2cli serena file get	Read a file or chunk	mcp2cli serena file get --relative-path src/main.py mcp2cli serena file get --relative-path src/main.py --start-line 10 --end-line 50	ref
mcp2cli serena file search	Search regex pattern across codebase	mcp2cli serena file search --substring-pattern 'def my_func'	ref
mcp2cli serena file list	List files in a directory	mcp2cli serena file list --relative-path . --recursive false	ref
mcp2cli serena file find	Find files by name mask	mcp2cli serena file find --file-mask '*.py' --relative-path src	ref
mcp2cli serena file replace	Replace pattern occurrences in a file		ref

Symbol

Command	Description	Example	Ref
mcp2cli serena symbol find	Find symbols by name path pattern	mcp2cli serena symbol find --name-path-pattern MyClass/my_method	ref
mcp2cli serena symbol overview	Get high-level symbol overview of a file	mcp2cli serena symbol overview --relative-path src/main.py	ref
mcp2cli serena symbol replace	Replace the body of a symbol		ref
mcp2cli serena symbol insert-after	Insert content after a symbol		ref
mcp2cli serena symbol insert-before	Insert content before a symbol		ref
mcp2cli serena symbol rename	Rename a symbol codebase-wide		ref
mcp2cli serena symbol refs	Find symbols referencing a symbol		ref
mcp2cli serena symbol delete	Delete a symbol if unreferenced		ref

Memory

Command	Description	Example	Ref
mcp2cli serena memory write	Write project info to named memory	mcp2cli serena memory write --memory-name 'auth/logic' --content 'Auth uses JWT'	ref
mcp2cli serena memory get	Read a memory	mcp2cli serena memory get --memory-name 'auth/logic'	ref
mcp2cli serena memory list	List available memories	mcp2cli serena memory list	ref
mcp2cli serena memory update	Edit memory via pattern replacement		ref
mcp2cli serena memory rename	Rename or move a memory		ref
mcp2cli serena memory delete	Delete a memory		ref

Shell / Project / Session

Command	Description	Example	Ref
mcp2cli serena shell	Execute a shell command	mcp2cli serena shell --command 'npm test'	ref
mcp2cli serena project activate	Activate a project by name or path	mcp2cli serena project activate --project my-project	ref
mcp2cli serena project onboarding	Perform project onboarding		ref
mcp2cli serena session config	Get current agent configuration		ref
mcp2cli serena session modes	Switch active agent modes	mcp2cli serena session modes --modes '["editing","interactive"]'	ref
mcp2cli serena session instructions	Get Serena Instructions Manual		ref

Discover Parameters

Append --help to any command for full parameter list:

mcp2cli serena file get --help

Note: Use Ref links in the Commands table above to view detailed parameter reference and more examples.

User Notes

MUST READ users/skill.md for custom workflows and tips. Config: MCP server settings live in ~/.agents/mcp2cli/servers.yaml - edit there to take effect.