Setup
Connect your AI assistant to your Limio environment in a few steps. You'll sign in with your existing Limio credentials — no API keys or tokens to manage.
Beta: The Limio MCP Server is in beta and available on Release 115 onwards. If your environment is on an earlier release, contact your Limio admin about upgrading.
What you'll need
Claude Desktop, Claude Code or Codex (other MCP-compatible clients should also work)
Your MCP server URL — your Limio environment URL with
/mcpappended (e.g.,https://your-tenant.your-domain.com/mcp)Your Limio login — the same credentials you use to sign in to Limio
Connect via Claude Desktop
Claude Desktop supports remote MCP servers as custom connectors.
Open Claude Desktop and go to Settings > Connectors
Click Add custom connector
Enter your Limio MCP server URL (e.g.,
https://your-tenant.your-domain.com/mcp)Click Add
Claude will open a browser window for you to sign in with your Limio credentials.
Once connected, enable the Limio connector in any conversation via the + button in the chat input, then Connectors.
Try asking: "Show me my Limio offers"
Team and Enterprise plans: An admin must first add the connector in Organization settings > Connectors. Team members can then connect from their own Settings > Connectors page.
Multiple environments: Add a separate connector for each environment (sandbox, pre-production, production). This keeps your environments isolated and lets you test workflows in sandbox before running them against production. You can name each connector to make it clear which environment it points to (e.g., "Limio Sandbox", "Limio Prod").
Read-only access: When adding a connector, you can restrict it to read-only tools. In Claude Desktop, go to your connector settings and disable write tools (create, update) if you only need to query data. This is a good default for production environments.
Connect to Claude Code
Run the following command in your terminal:
Replace the example URL with your environment URL. Claude Code will prompt you to authenticate through your browser on first use. You can use your existing credentials to authenticate. See the Claude Code MCP docs for more on managing MCP servers.
If you want to add multiple MCP servers (for example, one for each environment, you can name each one differently to make it clear which environment they refer to).
Tip: To make your Limio MCP server available across all projects, install it with the --scope user flag:
By default, Claude Code uses local scope, so the server is only available in the current project. Applying the user scope means you don't have to reinstall the server for each of your projects.
Once you have Claude Code open, you can run /mcp to see your available MCP servers. Select the one you just added and select Authenticate. This should open up a browser with a login screen. Use your regular Limio App credentials to sign in. It should display a success message. You can then close this window and start to use the Limio MCP inside of Claude Code.
Connect to Codex
Run the following command in your terminal:
Replace the example URL with your environment URL. You can then run:
to initiate the authentication flow.
Other MCP clients
Any client that supports remote MCP servers can connect. Point it at your MCP server URL — the server handles authentication automatically through your browser.
Troubleshooting
No hammer icon in Claude Desktop
Check that the config file is valid JSON and restart Claude Desktop
Login page doesn't appear
Verify the MCP server URL with your Limio admin
"Unauthorized" after login
Your Limio account may not have MCP access enabled — contact your Limio admin
If you're stuck, reach out to Limio Support.
Last updated
Was this helpful?