CLI and MCP

Use Seren from agents and terminals

Download the unified Seren binary for terminal workflows and local MCP, or connect supported assistants directly to hosted Seren MCP.

Install

Get the unified Seren binary

Release binaries are available for macOS, Linux, and Windows. The same binary provides the CLI and the local MCP server. Cargo users can install directly from the Seren repository.

Install the Seren CLI

cargo install --git https://github.com/serenorg/seren.git --package seren-cli

Download a release

Authenticate

Log in and verify the active profile

Browser login is the recommended interactive path. Automation can supply SEREN_API_KEY and select a profile with --profile or SEREN_PROFILE.

Authenticate and verify the Seren CLI

seren auth login
seren auth status
seren me

First workflows

Inspect before you change anything

These commands show your current employees, skills, databases, and pending approvals before you change anything.

Agents and cloud

Agents and cloud CLI commands

seren agent cloud overview
seren agent cloud approvals list --limit 20
seren agent managed-list

Skills and models

Skills and models CLI commands

seren skills search browser
seren skills installed
seren agent private-models list

Database

Database CLI commands

seren projects list
seren database list
seren branches --project-id <id> list

Passwords

Passwords CLI commands

seren passwords vaults list
seren passwords approvals list
seren passwords audit list

Automation

Request JSON in scripts and CI

The global output flag keeps the same commands useful to humans and automation. Prefer environment credentials in CI rather than passing an API key on the command line.

Use Seren CLI JSON output

export SEREN_API_KEY=your_seren_api_key

seren -o json agent cloud overview
seren -o json projects list

MCP

Choose hosted or local MCP

Hosted MCP is the default: you sign in through the browser and never copy an API key into the assistant. Run the local server instead when you want to authenticate with an API key or keep everything, including credential unlock, on your own machine.

Connect hosted Seren MCP

codex mcp add seren --url https://mcp.serendb.com/mcp
claude mcp add --scope user --transport http seren https://mcp.serendb.com/mcp

Run local Seren MCP

export API_KEY=your_seren_api_key
seren mcp start

# Claude CLI with the local stdio server
claude mcp add --scope user --env API_KEY=your_seren_api_key --transport stdio seren-local -- seren mcp start

Connect more MCP clients

Reference

Complete references

The repository references track every command group, argument, MCP mode, environment variable, and advanced security configuration next to the implementation.

CLI reference MCP reference