Skip to main content

Urhere MCP Integration

Allows you to connect ChatGPT, Claude, Google Gemini or another app to urhere.

What it is

The AI Connector lets you connect ChatGPT, Claude, Google Gemini or your own apps to urhere. Once it's connected, you can ask about your rosters, timesheets, leave and sales from that app, and make changes to them there.

Each person connects their own app using their Disconnecting an assistant

own urhere login. A connection can't be shared with anyone else.

How it works

Where to find it & connecting ChatGPT, Claude, Google Gemini or another assistant

  1. Select your profile in the top right, then Integrations.

  2. In the Developer section, select Manage next to AI Connector & API.

  3. Under Connected apps, select Copy to copy your connection address.

  4. In your AI assistant, add a new connector and paste the address.

  5. You'll be brought back to urhere. Check what the assistant will be able to do, then select Approve.

The assistant then appears under Connected apps.

Choosing what it can do

When you connect, you approve the full list of what the assistant can do. Afterwards, you can untick anything it doesn't need.

  1. Under Connected apps, select ⋮ on the assistant.

  2. Select Edit.

  3. Under What this app can do, tick only what it needs.

  4. Select Save.

Managing a connected assistant

Under Connected apps, select ⋮ on the assistant to:

  • Edit its name, description or what it can do.

  • See What it has been doing.

  • Stop it for now without removing it.

  • Disconnect it.

  • What it has been doing

    • Select ⋮ on the assistant, then What it has been doing to see how many changes it has made in the last hour, today and the last 7 days.

  • Limits: an assistant can make up to 5,000 changes a day and 60 a minute. If it starts changing things much faster than a person would, urhere stops it and lets you know.

  • Undo its changes: choose a time period, such as The last hour, and select Preview to see what will be undone.

    • Undoing puts things back the way they were before the assistant changed them. Anything your team has changed since is left alone.

Disconnecting an assistant

  1. Select your profile in the top right, then Integrations.

  2. In the Developer section, select Manage next to AI Connector & API.

  3. Under Connected apps, select ⋮ on the assistant.

  4. Select Disconnect or Stop for now.

The assistant can no longer access urhere.

Allowing managers to connect apps

Managers can't connect apps or AI assistants unless you switch it on for them. You can do this in either of two places. Both use the same switch, so changing it in one place changes it in the other.

From Integrations

  1. Select your profile in the top right, then Integrations.

  2. In the Developer section, select Choose who can connect apps.

  3. Switch on each manager you want to allow, then select Done.

From a manager's profile

  1. Open the employee's profile.

  2. Select Access & Permissions.

  3. Under System Roles, check the employee is set to Manager. If they're set to Employee, change it to Manager.

  4. Below the manager section, find Locations & Role Permissions and select Configure.

  5. Switch on Can connect apps & AI assistants.

Event notifications

Event notifications let urhere send an automatic update to another system whenever something changes, such as a shift being rostered or an employee being added. Select + Add a notification to choose which changes to send and the web address to send them to.

Each notification shows its web address, a short description, the changes it sends, and whether it's Active (sending updates) or Paused (not sending).

Select ⋮ on a notification to:

  • Edit its details or the changes it sends.

  • Start notifying again if it's paused.

  • Replace its signing secret. The other system uses the signing secret to check that updates really came from urhere. Replace it if you think it's been shared.

  • Delete it.

What we sent recently lists the latest updates. If one shows Did not arrive, the other system didn't receive it. Select Send again to retry it.

Event notifications are mainly for businesses connecting urhere to their own systems.

Helpful information

  • A connected app can only see and change what the person who connected it can. For example, if a manager can only access one location, an app they connect can only access that location too.

  • Changes made through a connected app are made straight away in urhere.

  • Times are shown in each location's own time zone.

Things you may use it for:

Once it's connected, you can ask your AI assistant for things in plain language, the same way you'd ask a colleague. Here are some examples of what it can help with.

Area

What you can do

Example

Rosters

• See who's working on any day or week, including open shifts nobody has picked up.

• Add shifts, including open shifts, with breaks and notes.

• Change, publish or cancel upcoming shifts.

"Add an open shift on Tuesday from 9am to 1pm."

Staff availability

• See when staff can't work, including repeating days off.

• Record a day someone can't work, once or repeating weekly.

• Change or remove unavailability for one day, or remove the whole repeat.

"Sam can't work Tuesdays until the end of the year."

Timesheets

• Check clock-in and clock-out times, breaks, hours, cost and approval status.

• Find out why a timesheet shows $0.

• Add time that wasn't rostered, or correct clock times and breaks. An approved timesheet needs to be unapproved first.

• Approve timesheets, or take an approval back.

"Which timesheets from last week still need approving?"

Leave

• See who's off, when, and whether their leave is approved, pending, declined or cancelled.

• Lodge a leave request for a staff member.

• Approve, decline or cancel leave requests.

"Who's off next week?"

Staff

• Look up staff by name, with their location, area, role and pay type.

• Add new staff, update their details, or archive someone who has left.

• Check whether someone's pay is set up, and why their shifts might cost $0.

Pay

• See someone's pay rates.

• Set someone's hourly pay, including Saturday, Sunday and public holiday rates.

• See what each worked shift cost.

Sales

• Record, correct or remove a day's takings.

• See each day's takings alongside rostered and worked hours.

Locations and settings

• Add a location, work area or role, or archive a location you no longer use.

• Check or change a location's settings, such as time rounding, breaks and shift swaps.

What an assistant can do depends on the permissions it has. Changes are made straight away in urhere.

What each permission means

Each area has two levels. View lets the assistant read information. Manage (or Set, Record or Change) lets it make changes.

  • View employees: read employee profiles, employments and assignments.

  • Manage employees: create, update and archive employees.

  • View locations: read locations, areas and roles.

  • Manage locations: create and update locations, areas and roles.

  • View the roster: read rosters and shifts.

  • Manage the roster: create and update rosters and shifts.

  • View timesheets: read timesheets and clock events.

  • Manage timesheets: create and update timesheets and clock events.

  • View leave: read leave requests and balances.

  • Manage leave: create and update leave requests.

  • View pay: read payroll data, pay rates and the pay ledger.

  • Set how people are paid: set salary type, rates, pay template and pay items.

  • View takings: read takings and how labour tracked against them.

  • Record takings: submit sales and labour data.

  • View schedule settings: read how the schedule and time clock are set up.

  • Change schedule settings: change how the schedule and time clock work, including clock-in and rounding rules.

  • View event notifications: see where updates are sent and what has been sent.

  • Manage event notifications: set up where updates are sent, and resend updates.

Tip: if the assistant only needs to look things up, untick everything except the View permissions.

Keeping your account secure

  • You stay in control. You choose what an assistant can do, and you can pause or disconnect it at any time.

  • It can never do more than you can. If you can only access one location, an assistant you connect can only access that location too. The same applies to managers.

  • It only ever sees your account.

  • No password is shared. You connect by pasting an address into your assistant and approving it in urhere. Your urhere password is never given to the assistant.

  • Only approve requests you expect. If an approval screen appears that you didn't start, select Cancel.

  • Connections are personal. Each person connects their own assistant with their own login, and a connection can't be shared.

  • Managers need your permission. Managers can't connect an assistant until the owner switches it on for them.

  • You can see and undo its changes. Select ⋮ on the assistant, then What it has been doing to see its changes and undo them if needed.

  • There are built-in limits. An assistant can make up to 5,000 changes a day and 60 a minute. If it changes things much faster than a person would, urhere stops it and lets you know.

  • Changes happen straight away. Anything an assistant changes is made immediately in urhere, the same as if you'd done it yourself.

What it can't access

  • Staff bank details, tax file numbers and super details

  • Your urhere billing and subscription

  • Anyone's password

  • Other urhere workspaces

  • Anything excluded from the list of areas it can access

Information your assistant reads from urhere is handled by that AI provider under its own privacy terms, for example OpenAI for ChatGPT, Anthropic for Claude or Google for Gemini.

Connect urhere to ChatGPT

Connect your urhere account to ChatGPT using MCP (Model Context Protocol). This lets ChatGPT use the tools available through your urhere connection.

Set up the connection

  1. Open ChatGPT on the web and go to Plugins.

  2. Select the + button, then Add custom MCP server.

  3. Enter urhere as the name.

  4. In Server URL, enter the url found in AI Connector from your profile (top right of screen)

  5. Select OAuth as the authentication method. If prompted for a client registration method, choose Dynamic Client Registration (DCR).

  6. Review the connection warning, tick I understand and want to continue, then select Create as a plugin.

  7. Open the resulting urhere plugin and select Install. Follow the connection prompts to sign in to urhere and review the requested permissions.

If your workspace already has the urhere plugin installed, open the existing plugin and connect your account.

How to: Connect urhere to Claude

  1. In Claude, go to Settings → Connectors.

  2. Click Add custom connector, name it urhere, paste [URHERE CONNECTOR URL] and click Add.

  3. Click Connect and log in with your urhere details.

  4. Open a new chat and ask Claude about your rosters, timesheets or leave.

*Custom connectors are available on paid Claude plans.

Did this answer your question?