MangoApps for Claude

Setup

For end users (one-click connect)

1. In Claude.ai, open Settings → Connectors.
2. Find MangoApps in the directory and click Connect. (If you don't see it in the directory yet, choose Add custom connector and paste https://mcp.iq.mangoapps.com/api/v1/mcp.)
3. You'll be redirected to a "Which MangoApps tenant?" page. Enter your tenant slug — the part of your MangoApps URL before .workforce.mangoapps.com. For example, if you sign in at acme.workforce.mangoapps.com, enter acme.
4. Sign in to MangoApps if you're not already.
5. The consent screen lists every MangoApps domain Claude is requesting access to (Forms, Tasks, etc.). Review and click Authorize.
6. You're returned to Claude with the connector active. Start a new chat and ask anything — "list my recent form submissions", "summarize last week's surveys", "what's overdue on my OKRs?"

For Claude Desktop

Open ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) and add:

{
  "mcpServers": {
    "mangoapps": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.iq.mangoapps.com/api/v1/mcp"]
    }
  }
}

Quit Claude Desktop fully (Cmd+Q) and relaunch. The first connection opens your browser for the OAuth consent flow, then the connector is ready.

Tools and scopes

The connector exposes 885 tools across 80 product domains. Each tool declares whether it is read-only or destructive via standard MCP annotations (readOnlyHint, destructiveHint), and Claude.ai surfaces these badges in the consent screen and tool-call approval dialogs.

Scope naming

Scopes use the pattern read:<domain> and write:<domain> for every product domain that exposes tools. For example:

• read:forms — View forms and your submissions
• write:forms — Create forms and submit form data
• read:tasks / write:tasks — Tasks app
• read:reporting — Run reports and view dashboards
• mcp:all_tools — Broad access to every domain (admin-only; see "Privilege gate" above)

The complete scope list is published at /.well-known/oauth-authorization-server on every MangoApps tenant.

Sample prompts

What Claude can do, with the right scopes:

• "List the 5 most recent form submissions for the new-hire onboarding form."
• "Create a feedback survey for the new field-team app, set it to expire in 14 days."
• "What's overdue on my OKRs? Group by quarter."
• "Summarize last month's engagement survey — top themes broken down by department."
• "Find every shift this week that conflicts with an approved time-off request."
• "Post to the news feed announcing the Q3 results, with highlights from the attached board deck."

Troubleshooting

"I authorized but Claude says no tools are available"

The most common cause is that your tenant has disabled some or all marketplace apps, so even with broad scopes the catalog is empty. Ask your admin to check /admin/marketplace_apps for app enablement. If you're on a non-admin role, you may have requested scopes that exceeded your visibility — try a narrower scope like read:forms first.

"Tool call returns 'not accessible'"

The corresponding app was disabled for your tenant, or your user account is outside the app's visibility group. Ask your tenant administrator.

"OAuth flow doesn't complete in Claude Desktop"

For dev tenants that use self-signed TLS certificates, set NODE_TLS_REJECT_UNAUTHORIZED=0 in the env block of your claude_desktop_config.json. Never use this in production.

"I want to revoke a connector immediately"

End users: in Claude, open Settings → Connectors → MangoApps → Revoke. Tenant admins: from MangoApps, open /admin/connectors, find the application row, click Revoke. Either path invalidates the token immediately.