Exclugo for Claude (facility account)

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 an API token from your Exclugo admin

Ask your Exclugo administrator for an API token. It looks like a long string of letters and numbers.

They already have a snippet for this in the Exclugo-for-Claude README, under Generating an API token.

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”

Ask your Exclugo admin for a new token and paste it in place of the old one. 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.

For Exclugo administrators

Issue a Django REST token for the facility user (same snippet as in the Exclugo-for-Claude README under Generating an API token). Send only the token — not a password.

This server is facility-only. The user’s existing Exclugo permissions still apply.

To publish a new version:

cd exclugo-client-mcp
# bump version in pyproject.toml first
rm -rf dist
python -m build
twine upload dist/*

License

MIT