Empowill in your AI agent Beta

Added once as a custom connector, it is available on claude.ai, Claude Desktop, Cowork and the mobile apps.

1. Open Customize > Connectors, click + then Add custom connector.
2. Paste the server URL: https://<API host>/mcp.
3. Open Advanced settings and set OAuth Client ID to empowill-mcp. Leave OAuth Client Secret empty.
4. Click Add, then Connect: sign in to Empowill and click Allow.

On Claude Team and Enterprise plans, an owner first adds the connector in Organization settings > Connectors (Add > Custom > Web, same URL and advanced settings); each member then clicks Connect in Customize > Connectors. Menu names follow Anthropic's guide and may change on their side.

Add the server from your terminal:

claude mcp add --transport http --client-id empowill-mcp --callback-port 33418 empowill https://<API host>/mcp

1. In Claude Code, run /mcp, select empowill and choose Authenticate.
2. Your browser opens the Empowill sign-in page, then the consent screen: click Allow.
3. Back in Claude Code, the Empowill tools are ready to use.

Leave the client secret out: empowill-mcp has none. Port 33418 must be free on your computer during sign-in — it receives the authorization. To start on another of your companies than your main one, add --header "Company-Id: <company-id>"; otherwise, just ask the agent to switch company.

Add the server, then sign in:

codex mcp add empowill --url https://<API host>/mcp --oauth-client-id empowill-mcp

codex mcp login empowill

Your browser opens the Empowill sign-in page, then the consent screen: click Allow. There is no port to configure. Keep the URL exactly as shown, without a trailing slash: the sign-in depends on it.

Or declare the server in Codex's config.toml, then run the same login command:

[mcp_servers.empowill]
url = "https://<API host>/mcp"

[mcp_servers.empowill.oauth]
client_id = "empowill-mcp"

Run MCP: Open User Configuration from the Command Palette (or edit your project's .vscode/mcp.json) and add the server:

{
  "servers": {
    "empowill": {
      "type": "http",
      "url": "https://<API host>/mcp"
    }
  }
}

1. Start the server (MCP: List Servers, then start it), or just send a message in agent mode.
2. VS Code asks for a Client ID: enter empowill-mcp.
3. It then asks for a Client Secret: leave it empty.
4. Your browser opens the Empowill sign-in page, then the consent screen: click Allow.

Port 33418 must be free on your computer during sign-in. To start over, run Authentication: Remove Dynamic Authentication Providers. On Copilot Business and Enterprise, your GitHub administrator must enable the MCP servers in Copilot policy.

Add the server to ~/.gemini/settings.json:

{
  "mcpServers": {
    "empowill": {
      "httpUrl": "https://<API host>/mcp",
      "oauth": {
        "enabled": true,
        "clientId": "empowill-mcp",
        "redirectUri": "http://localhost:33418/oauth/callback"
      }
    }
  }
}

Start Gemini CLI with the callback port set (macOS and Linux syntax), then sign in:

OAUTH_CALLBACK_PORT=33418 gemini

/mcp auth empowill

Your browser opens the Empowill sign-in page, then the consent screen: click Allow. The callback port must be 33418 on both sides — in redirectUri and in OAUTH_CALLBACK_PORT — and free during sign-in.

Add the server to ~/.cursor/mcp.json (or your project's .cursor/mcp.json), with no client secret:

{
  "mcpServers": {
    "empowill": {
      "url": "https://<API host>/mcp",
      "auth": {
        "CLIENT_ID": "empowill-mcp"
      }
    }
  }
}

Cursor then offers to connect to the server: sign in to Empowill and click Allow. With the desktop app, port 8787 must be free during sign-in. Cursor's web and cloud agents work too.