Exclugo Client MCP

These instructions are for Claude Desktop. Support for other AI assistants is coming soon.

Talk to Claude about your Exclugo account — dashboard, people, licenses, alerts, reports, and orders — in plain English.

After a one-time setup, you never log in. There is no username or password. Your Exclugo admin gives you an API token once; you paste it into Claude Desktop.

Setup (about 5 minutes)

1. Install uv

uv is a small tool that runs Exclugo for Claude. You only install it once.

Mac

1. Open Terminal (Cmd + Space, type Terminal, press Enter).

2. Paste this and press Enter:

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

3. Quit Terminal completely (Cmd + Q) and reopen it.

Windows

1. Open PowerShell.

2. Paste this and press Enter:

   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
   

3. Close PowerShell completely and reopen it.

2. Get your API token

1. Log in to Exclugo and go to Users (app.exclugo.com/users).
2. Click Edit on the user you want to connect.
3. Scroll to the Claude Token section and copy the token.

If you don't see the Users page or the Claude Token section, ask your account admin to enable user management for your login.

3. Add it to Claude Desktop

1. Open Claude Desktop.

2. Claude menu → Settings… → Developer → Edit Config.

3. Paste this (replace paste-token-here with your token):

   {
     "mcpServers": {
       "exclugo-client": {
         "command": "uvx",
         "args": ["exclugo-client-mcp"],
         "env": {
           "EXCLUGO_BASE_URL": "https://app.exclugo.com",
           "EXCLUGO_API_TOKEN": "paste-token-here"
         }
       }
     }
   }
   

   If you already have other servers listed, add only the "exclugo-client": { ... } block inside "mcpServers".

4. Save (Cmd + S or Ctrl + S).

5. Fully quit Claude Desktop (Cmd + Q on Mac) and reopen it.

You should see a hammer icon in the chat box. Click it — those are your Exclugo tools.

Try it

• Show me my dashboard.
• Who is flagged at my facilities?
• Find Jane Doe born 1984-03-12.
• Open report 184920.
• Which licenses expire in the next 30 days?
• Order a new employee screening for John Smith at Sunrise Care.

Claude only sees your account. If something is turned off for your login, Claude will say your account admin needs to enable it in Exclugo.

Troubleshooting

“Failed to spawn process: No such file or directory”

uv is not installed, or Claude was not restarted after installing it. Redo step 1, then fully quit and reopen Claude Desktop.

If it still fails, run which uvx (Mac) or where.exe uvx (Windows), and put that full path in the config as "command" instead of "uvx".

Claude does not show Exclugo tools

Save the config, fully quit Claude, and reopen it. Check the JSON at jsonlint.com.

”This token isn't valid”

Go to Users in Exclugo, edit the user, and copy a fresh token from the Claude Token section. Paste it in the config and restart Claude.

“You don't have permission”

Your login does not have that action turned on (for example Process reports, Manage users, Monitoring, or Preferences). Ask your account admin to enable it in Exclugo.

License

MIT