# onelogin-mcp

Connect an AI agent to the OneLogin API to manage users, apps, roles, and authentication settings through natural-language requests.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7 repo stars
- Author: onelogin
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/onelogin/onelogin-mcp
- Updated: 2026-09-14
- Security check: automated, 2026-11-16 (text) — warning: a command downloads a script from bun.sh and runs it right away. Do not run such commands without an explicit yes from the human.
- HTML: https://affpapa.org/en/nevibecode/mcp/onelogin-mcp

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `ONELOGIN_URL`, `ONELOGIN_CLIENT_ID`, `ONELOGIN_CLIENT_SECRET` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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 <…> with your own values

### Codex

**Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

## When to use it
- 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
- Find users whose email address ends with `@example.com`.
- Assign roles `123` and `456` to user `789`.
- Show me every SAML app in OneLogin.

## Similar
- [Opplevagent — Norwegian Experiences](https://affpapa.org/en/nevibecode/mcp/opplevagent-norwegian-experiences.md) — MCP server · 170 installs
- [MoltPe](https://affpapa.org/en/nevibecode/mcp/moltpe.md) — MCP server · 170 installs
- [Shipi](https://affpapa.org/en/nevibecode/mcp/shipi.md) — MCP server · 162 installs
- [neuron-whatsapp](https://affpapa.org/en/nevibecode/mcp/neuron-whatsapp.md) — MCP server · 152 installs
- [Bushdrum Events](https://affpapa.org/en/nevibecode/mcp/bushdrum-events.md) — MCP server · 150 installs
- [WordPress](https://affpapa.org/en/nevibecode/mcp/wordpress.md) — MCP server · 138 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
