For AI Agents

Model Context Protocol

Connect Relvios to your favorite AI CLI tools or desktop agents. Our MCP server allows AI to read threads and send direct replies securely.

Available Tools

When you connect Relvios to an AI agent using the Model Context Protocol, the agent gains access to the following tools:

list_threads

List inbox threads. Supports filtering by source, status, priority, and search queries.

read_thread

Read a full thread along with all of its associated messages and internal notes.

send_reply

Directly send a real outbound reply to a thread utilizing the configured integration (e.g. SMTP or Gmail).

list_workspaces

List all workspaces (id and name) where the current API key creator is an admin or owner.

get_new_messages

Fetch new messages across all threads since a specific ISO date string (useful for polling).

Integrations

To install the Relvios MCP server, you will need a Workspace API key. Below are the configuration instructions for popular AI clients.

Claude Code

Add the MCP server directly using the CLI command:

$ claude mcp add relvios-uninbox "npx" "-y" "relvios-mcp-bridge"

Gemini CLI

Add the following to your gemini_settings.json:

{ "mcpServers": { "relvios-uninbox": { "command": "npx", "args": ["-y", "relvios-mcp-bridge"], "env": { "RELVIOS_API_KEY": "YOUR_API_KEY", "RELVIOS_BASE_URL": "https://api.relvios.com/api" } } } }

Codex CLI

Add the following to your codex_config.toml:

[mcp_servers.relvios-uninbox] command = "npx" args = ["-y", "relvios-mcp-bridge"] [mcp_servers.relvios-uninbox.env] RELVIOS_API_KEY = "YOUR_API_KEY" RELVIOS_BASE_URL = "https://api.relvios.com/api"

ZeroClaw & OpenCode

ZeroClaw and OpenCode support similar TOML and JSON configurations. Reference the configuration examples in the mcp-configs/ directory of the Relvios codebase for zeroclaw_config.toml and opencode.json.