Skip to main content
Codex adds Melso from the terminal or from its configuration file. Codex documents no install link, so setup is two commands.

Add Melso to Codex

Run codex mcp add melso --url https://mcp.melso.ai/mcp, then codex mcp login melso.

​
Before you start

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

​
Connect

1

Add the server

2

Sign in with Melso

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

Check the server

Run codex mcp list, or /mcp inside Codex, and check that melso is listed.
4

Make the first read

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

​
Manual configuration

Add a table to ~/.codex/config.toml, or to a project’s .codex/config.toml, then run codex mcp login melso:
Do not set bearer_token_env_var or headers for Melso. The OAuth login stores the credential.

​
First request

Codex calls company, as in Try a first read. Then try the calendar: taxes with {"action": "calendar"}. The tool catalog lists every tool, and each page shows its input schema; what you see depends on the plan, your role and setup (Permissions and approvals). Check result.isError before relying on a result, as Read MCP results explains. Codex 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 Codex: delete the [mcp_servers.melso] table from config.toml. codex mcp --help lists the other MCP commands for your version.
  • In Melso: Configuración, tab MCP, then Desconectar next to the connection.

​
If something fails

  • Tools fail with an authentication error. Run codex mcp login melso again.
  • Other causes are in Troubleshooting.

​
Source and verification

The commands and configuration follow the Codex MCP guide, which now opens at learn.chatgpt.com. It was checked on 20 October 2026. This confirms the documented syntax, not a tested connection in your account.