Skip to main content
Gemini CLI adds Melso with one command and signs in from inside the CLI. This page covers Gemini CLI only; it does not describe the Gemini app.

Add Melso to Gemini CLI

Run gemini mcp add --transport http melso https://mcp.melso.ai/mcp, then /mcp auth melso.

​
Before you start

  • Gemini CLI installed and signed in.
  • A Melso account in the company you want Gemini CLI to use.

​
Connect

1

Add the server

The server is saved for the current project. Add --scope user to use it everywhere. Do not add --trust: it skips the confirmation prompt on every tool call.
2

Start Gemini CLI

Run gemini in the same project.
3

Sign in with Melso

Your browser opens Melso’s OAuth screen. Choose the company and review the requested access.
4

Make the first read

Ask: “Read my Melso company without changing anything.”

​
Manual configuration

Add Melso to the mcpServers object in settings.json (.gemini/settings.json in a project, or ~/.gemini/settings.json). Use httpUrl for Streamable HTTP; url selects the older SSE transport:

​
First request

Gemini CLI calls company, as in Try a first read. Then ask for your expenses or the tax calendar. Run /mcp list to see the Melso tools you were given; what you see depends on the plan, your role and setup (Permissions and approvals and the tool catalog). Gemini CLI can draft invoices. It issues one only when the owner asks, through the owner’s own connection, and the prerequisites are met; otherwise the owner issues it in the Melso app. No tool approves, files or pays a tax return.

​
Disconnect

  • In Gemini CLI: gemini mcp remove melso.
  • In Melso: Configuración, tab MCP, then Desconectar next to the connection.

​
If something fails

  • Tokens expired. Run /mcp auth melso again.
  • The server does not connect. Check that the configuration uses httpUrl, not url.
  • Other causes are in Troubleshooting.

​
Source and verification

The commands and configuration follow the Gemini CLI MCP server guide, checked on 20 October 2026. This confirms the documented syntax, not a tested connection in your account.