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).
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.
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
- 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
- Production or Developer Edition:
- Select Install for Admins Only. The permission set in step 2 gives users exactly what the tools need.
- 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
- From Setup, enter
MCPin Quick Find, then select MCP Servers (under Integrations → API Catalog). - Click Add MCP Server → Create Salesforce MCP Server, with the name
Resource Hero Userand the API nameResourceHeroUser. - On the server’s Tools tab, click Add Server Assets and add the 16 Apex actions in the
rhamcpnamespace. The header shows Tools 16. - Click Edit on each tool to give it a short Tool Name and its annotations:
| Tool | Tool Name | Annotations |
|---|---|---|
| Get My Assignments | getMyAssignments | Read-only, Idempotent |
| Get My Tracked Time | getMyTrackedTime | Read-only, Idempotent |
| Get My Timers | getMyTimers | Read-only, Idempotent |
| Get My Time Summary | getMyTimeSummary | Read-only, Idempotent |
| Get My Time Off | getMyTimeOff | Read-only, Idempotent |
| Get My Forecast | getMyForecast | Read-only, Idempotent |
| Get My Capacity | getMyCapacity | Read-only, Idempotent |
| Insert Actuals | insertActuals | none |
| Update Actuals | updateActuals | Idempotent, Destructive |
| Delete Actuals | deleteActuals | Destructive |
| Start Timer | startTimer | none |
| Pause Timer | pauseTimer | none |
| Stop Timer | stopTimer | none |
| Cancel Timer | cancelTimer | Destructive |
| Request Time Off | requestTimeOff | none |
| Cancel Time Off | cancelTimeOff | Destructive |
Leave Open world unchecked on every tool.
- Click Activate.
- 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
- From Setup, open External Client App Manager and click New External Client App. Name it
Resource Hero MCPand set Distribution State to Local. - Under API (Enable OAuth Settings), select Enable OAuth and set:
- Callback URL:
https://claude.ai/api/mcp/auth_callbackfor Claude on the web and desktop, andhttp://localhost:8765/callbackfor 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.
- Callback URL:
- Click Create. Salesforce can take a few minutes to make a new app available.
- 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:
- 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.
- Add the Resource Hero plugin in Organization settings → Plugins & skills: click Add → Upload a plugin and upload
rh-user.zipfrom 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:
- Open the Resource Hero User server, click Deactivate, then delete it.
- Remove the Resource Hero MCP User permission set from every user. Note who had it.
- From Setup → Installed Packages, uninstall Resource Hero MCP. Users’ time, timers and time off stay as they are.
- 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 sees | Fix |
|---|---|
| “invalid_client_id” when signing in | The External Client App isn’t available yet (wait a few minutes), or the consumer key was mistyped. |
| “OAUTH_AUTHORIZATION_BLOCKED” or a cross-org error | The 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 missing | Add it to the server, then the user reconnects. |
| NO_RESOURCE or MULTIPLE_RESOURCES | Link exactly one active Resource record to the user. |
| NOT_LICENSED | Assign the user a Resource Hero license. |
| NO_ACCESS | Assign 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.