Set Up Resource Hero for Claude

Connect Claude, the AI assistant from Anthropic, to Resource Hero in your org so your users can log time, run timers, check their forecast and capacity, and request time off by asking Claude, in Claude on the web and desktop or in Claude Code. You set it up once per org, in about 30 minutes; each user then connects with their own Salesforce login (see Resource Hero for Claude).

Note:

Resource Hero for Claude requires Resource Hero v16.2 or later and is in early access (Resource Hero MCP extension v0.1). While we work on getting it live on the AppExchange, a future version may need you to uninstall the extension and install the new one instead of upgrading. See Moving to a New Version.

How It Fits Together

  • The Resource Hero MCP extension is a free managed package that adds 16 Resource Hero tools to your org: list my assignments, log, change and delete my time, run timers, summarize my time, forecast and capacity, and request time off.
  • A Resource Hero User MCP server is a Salesforce-hosted MCP server you create in Setup. It offers exactly those 16 tools and nothing else. Claude connects to it.
  • An External Client App lets Claude sign in to that server as each user, through the normal Salesforce login.

Everything runs as the signed-in user. Users see and change only their own time, and your sharing, field security, validation rules and flows apply as they do in RH Time Tracking. Every tool checks the user’s Resource Hero license first.

Note:

Setup shows “You might be billed for Salesforce MCP server usage” on the MCP Servers page. Salesforce plans to charge Flex Credits for agent calls to production orgs; ask your Salesforce account executive how this applies to your contract. Resource Hero doesn’t charge for the extension.

Step 1: Install the Resource Hero MCP Extension

  1. Open the install link for your org, signed in as an admin:
    • Production or Developer Edition: https://login.salesforce.com/packaging/installPackage.apexp?p0=04tPf000001ipflIAA
    • Sandbox: https://test.salesforce.com/packaging/installPackage.apexp?p0=04tPf000001ipflIAA
  2. Select Install for Admins Only. The permission set in step 2 gives users exactly what the tools need.
  3. Click Install.

Step 2: Give Users Access

Each user who will use Claude needs:

  • The Resource Hero MCP User permission set, from the extension. It carries everything the tools need; no other Resource Hero permission set is required.
  • A Resource Hero license.
  • Exactly one active Resource record linked to their user.

Assign the permission set from Setup → Permission Sets → Resource Hero MCP User → Manage Assignments → Add Assignment.

The permission set includes create and edit access to the Time Off Request object, so users can request and cancel their own time off. New requests get your org’s default status for a Time Off Request, so your own approval process applies.

Step 3: Create the Resource Hero User MCP Server

  1. From Setup, enter MCP in Quick Find, then select MCP Servers (under Integrations → API Catalog).
  2. Click Add MCP Server → Create Salesforce MCP Server, with the name Resource Hero User and the API name ResourceHeroUser.
  3. On the server’s Tools tab, click Add Server Assets and add the 16 Apex actions in the rhamcp namespace. The header shows Tools 16.
  4. Click Edit on each tool to give it a short Tool Name and its annotations:
ToolTool NameAnnotations
Get My AssignmentsgetMyAssignmentsRead-only, Idempotent
Get My Tracked TimegetMyTrackedTimeRead-only, Idempotent
Get My TimersgetMyTimersRead-only, Idempotent
Get My Time SummarygetMyTimeSummaryRead-only, Idempotent
Get My Time OffgetMyTimeOffRead-only, Idempotent
Get My ForecastgetMyForecastRead-only, Idempotent
Get My CapacitygetMyCapacityRead-only, Idempotent
Insert ActualsinsertActualsnone
Update ActualsupdateActualsIdempotent, Destructive
Delete ActualsdeleteActualsDestructive
Start TimerstartTimernone
Pause TimerpauseTimernone
Stop TimerstopTimernone
Cancel TimercancelTimerDestructive
Request Time OffrequestTimeOffnone
Cancel Time OffcancelTimeOffDestructive

Leave Open world unchecked on every tool.

  1. Click Activate.
  2. From the server’s menu, select Copy Server URL and keep it for step 5.

If you use the Salesforce CLI, you can deploy the server definition instead of building it by hand. It’s in the Resource Hero toolkit on GitHub, with every tool name and annotation set. Activate it in Setup after deploying.

Step 4: Create the External Client App

  1. From Setup, open External Client App Manager and click New External Client App. Name it Resource Hero MCP and set Distribution State to Local.
  2. Under API (Enable OAuth Settings), select Enable OAuth and set:
    • Callback URL: https://claude.ai/api/mcp/auth_callback for Claude on the web and desktop, and http://localhost:8765/callback for Claude Code, one per line.
    • OAuth Scopes: Access Salesforce hosted MCP servers (mcp_api), and Perform requests at any time (refresh_token, offline_access).
    • Security: select Require Proof Key for Code Exchange (PKCE) and Issue JSON Web Token (JWT)-based access tokens for named users; clear Require secret for Web Server Flow.
  3. Click Create. Salesforce can take a few minutes to make a new app available.
  4. On the app’s Settings tab, open OAuth Settings → Consumer Key and Secret and copy the Consumer Key. It isn’t a secret: each user still signs in with their own login.

Step 5: Connect Claude

For a Claude Team or Enterprise organization, an Owner can set this up once for everyone:

  1. In Claude, open Organization settings → Connectors and add a custom connector named “Resource Hero” with the server URL from step 3 and, under Advanced settings, the consumer key from step 4 as the OAuth Client ID.
  2. Add the Resource Hero plugin in Organization settings → Plugins & skills: click Add → Upload a plugin and upload rh-user.zip from the toolkit’s releases, then set its Default access to Installed by default.

Otherwise, send your users the server URL and the consumer key, and point them to Resource Hero for Claude. Claude Code users add the server with:

claude mcp add --transport http --scope user --client-id <consumer key> --callback-port 8765 resource-hero <server URL>

Moving to a New Version

When a new version of the extension can’t upgrade the one you have, the release notes say so. Salesforce won’t uninstall the extension while it’s in use, so:

  1. Open the Resource Hero User server, click Deactivate, then delete it.
  2. Remove the Resource Hero MCP User permission set from every user. Note who had it.
  3. From Setup → Installed Packages, uninstall Resource Hero MCP. Users’ time, timers and time off stay as they are.
  4. Install the new version, create the server again with the same API name ResourceHeroUser, activate it, and give the permission set back to the same users.

The External Client App stays, and with the same API name the server URL doesn’t change, so users’ Claude connectors keep working.

Troubleshooting

What the user seesFix
“invalid_client_id” when signing inThe External Client App isn’t available yet (wait a few minutes), or the consumer key was mistyped.
“OAUTH_AUTHORIZATION_BLOCKED” or a cross-org errorThe browser is signed in to a different org. Sign out of it, or use a private window.
“MCP endpoint not found”The server isn’t activated, or the URL wasn’t copied from Setup.
A tool is missingAdd it to the server, then the user reconnects.
NO_RESOURCE or MULTIPLE_RESOURCESLink exactly one active Resource record to the user.
NOT_LICENSEDAssign the user a Resource Hero license.
NO_ACCESSAssign the Resource Hero MCP User permission set.

The full admin guide, with the server and External Client App templates, is in the Resource Hero toolkit on GitHub.


Related Support Posts:

Ready to get started?

Schedule a call to see if Resource Hero is right for you

Book now