onelogin-mcp — Claude Code MCP server: features and setup
Connect an AI agent to the OneLogin API to manage users, apps, roles, and authentication settings through natural-language requests.
MIT ★ 7 updated 2026-09-14
claude mcp add onelogin-mcp -e ONELOGIN_URL=<ONELOGIN_URL> -e ONELOGIN_CLIENT_ID=<ONELOGIN_CLIENT_ID> -e ONELOGIN_CLIENT_SECRET=<ONELOGIN_CLIENT_SECRET> -- npx -y @onelogin/onelogin-mcpWhat onelogin-mcp does
The server gives an agent tools for working with OneLogin. It can look up users and groups, assign roles, inspect applications, and handle MFA. Other operations cover sessions, security policies, events, and reports. Ask in plain language; the agent selects a tool and sends the request to the OneLogin API.
There are 156 tools across seven categories, including identity and access, applications, authentication, and monitoring. You need a OneLogin URL plus an OAuth2 client ID and secret. Claude Code registers the server with claude mcp add and runs it through npx; without those credentials, it cannot access the API.
Set ONELOGIN_URL, ONELOGIN_CLIENT_ID, and ONELOGIN_CLIENT_SECRET as environment variables. You can also save settings in a configuration file using npx onelogin-mcp-setup; environment variables take precedence. Listed client platforms also include Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, and Gemini CLI.
What it helps with
- find users by email address
- assign roles to a user
- list SAML applications
- create a OneLogin user
- generate an MFA token for a user
Example prompts for the agent
- Find users whose email address ends with
@example.com. - Assign roles
123and456to user789. - Show me every SAML app in OneLogin.
How to install onelogin-mcp
Platform CLI
claude mcp add onelogin-mcp -e ONELOGIN_URL=<ONELOGIN_URL> -e ONELOGIN_CLIENT_ID=<ONELOGIN_CLIENT_ID> -e ONELOGIN_CLIENT_SECRET=<ONELOGIN_CLIENT_SECRET> -- npx -y @onelogin/onelogin-mcpReplace <…> with your own values
Platform CLI
codex mcp add onelogin-mcp --env ONELOGIN_URL=<ONELOGIN_URL> --env ONELOGIN_CLIENT_ID=<ONELOGIN_CLIENT_ID> --env ONELOGIN_CLIENT_SECRET=<ONELOGIN_CLIENT_SECRET> -- npx -y @onelogin/onelogin-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"onelogin-mcp": {
"command": "npx",
"args": [
"-y",
"@onelogin/onelogin-mcp"
],
"env": {
"ONELOGIN_URL": "<ONELOGIN_URL>",
"ONELOGIN_CLIENT_ID": "<ONELOGIN_CLIENT_ID>",
"ONELOGIN_CLIENT_SECRET": "<ONELOGIN_CLIENT_SECRET>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"onelogin-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@onelogin/onelogin-mcp"
],
"env": {
"ONELOGIN_URL": "<ONELOGIN_URL>",
"ONELOGIN_CLIENT_ID": "<ONELOGIN_CLIENT_ID>",
"ONELOGIN_CLIENT_SECRET": "<ONELOGIN_CLIENT_SECRET>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e ONELOGIN_URL=<ONELOGIN_URL> -e ONELOGIN_CLIENT_ID=<ONELOGIN_CLIENT_ID> -e ONELOGIN_CLIENT_SECRET=<ONELOGIN_CLIENT_SECRET> onelogin-mcp npx -y @onelogin/onelogin-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about onelogin-mcp
How do I install onelogin-mcp in Claude Code?
Run `claude mcp add onelogin-mcp -e ONELOGIN_URL=<ONELOGIN_URL> -e ONELOGIN_CLIENT_ID=<ONELOGIN_CLIENT_ID> -e ONELOGIN_CLIENT_SECRET=<ONELOGIN_CLIENT_SECRET> -- npx -y @onelogin/onelogin-mcp`. Replace the placeholders with your OneLogin URL and OAuth2 client credentials.
What does onelogin-mcp do?
It connects an agent to the OneLogin API for tasks involving users, roles, apps, and authentication settings. The server provides 156 tools grouped into seven categories.
What credentials does onelogin-mcp need?
Provide the OneLogin URL, OAuth2 client ID, and client secret. You can set them as environment variables or save them with npx onelogin-mcp-setup.