AI assistants

Connect Claude to Toku

Let Claude look up and act on your Toku HR data, signed in as you.

Toku works as a connector for Claude. Once connected, you can ask Claude about your people, onboarding, invoices, expenses, time off, payslips and documents in plain English, and have it take the same actions you would take in Toku.

Claude signs in as you. It sees only your organization, and only the pages your Toku permissions let you see.

Before you start#

  • Your organization must be switched on. Toku enables this one organization at a time. Ask your Toku contact if you are not sure.
  • You need to be an admin of your organization in Toku.
  • Two-factor authentication must be on for your Toku login, or you sign in with your company's single sign-on. If you turned two-factor on just now, allow five minutes before connecting.

Connect#

The address of the Toku connector is:

https://api.toku.com/mcp
  1. Open Customize → Connectors, choose Add, then Add custom connector.
  2. Name it Toku and paste https://api.toku.com/mcp as the URL. Leave the advanced settings empty.
  3. Choose Add, then Connect. A Toku sign-in window opens.
  4. Sign in with your Toku login and complete your two-factor step.
  5. Back in Claude, check that Toku is listed as Connected under Customize → Connectors → Yours, then start a new chat.

On a Team or Enterprise plan, an owner of your Claude organization may need to add the connector first; you then only choose Connect.

The connector signs in as whoever is signed in to Toku in that browser. If you share a computer or use several Toku logins, sign out of Toku first, or use a separate browser profile.

Check it works#

Ask Claude:

Which organization am I connected to in Toku?

It should name your organization. If Claude reaches for an "organization context" tool and is refused, that is expected (those tools are for Toku staff): ask it to use Toku's discover tool to find the current-organization operation instead. Any other refusal is covered in If something is refused.

How Claude uses Toku#

Toku offers Claude a small set of tools that find and run its operations: discover searches them, describe explains one, dispatch_readonly runs a read, and dispatch runs anything, including changes. The first time Claude uses each one, Claude asks for your permission. Choosing Always allow for discover, describe and dispatch_readonly is reasonable, since they cannot change anything. Keep dispatch on Allow once, so you see each change before it happens.

What you can ask#

AreaTry asking
People"List everyone in my organization." "Show Maria's compensation history."
Onboarding"Who is still onboarding, and what is each person missing?"
Contractor invoices"Which contractor invoices are waiting for my review?"
Expenses"Show expense reports submitted this month."
Time off"Who is off next week?" "What is Sam's leave balance?"
Payslips"Find last month's payslips."
Documents"List our company documents."
Tasks"What admin tasks are waiting for me?"

Claude can also make changes: add a person, submit a change request, approve or reject a contractor invoice, approve an expense report, record or approve time off, and add a document. Changes go through dispatch, so as long as you keep it on Allow once, Claude asks you before every change. Read what it is about to do before you approve it.

What Claude sees#

  • Your organization only. It cannot see or act on any other organization.
  • Your permissions. If a page is set to No Access for you in Toku, Claude cannot use it either; with View Only it can read but not change.
  • Less than the app shows. Bank account numbers are masked, and download links expire after five minutes, so ask again for a fresh link if one stops working.

Anything you ask and anything Toku returns becomes part of your Claude conversation, under your Claude account's data settings.

Disconnect or switch account#

  • Claude (web and desktop): Customize → Connectors → Yours → Toku → Disconnect.
  • Claude Code: run /mcp, pick toku and choose Clear authentication, or remove it with claude mcp remove toku.

To connect as someone else, disconnect, sign out of Toku in your browser, then connect again.

If something is refused#

Claude saysWhat it means
"This caller is not allowed to do that"Your organization is not switched on yet, two-factor is not on for your login, or your role is not admin. Check Before you start, then contact Toku.
"Access to … is required"Your Toku permissions do not include that page. Another admin can change them under Team & Permissions.
"Full access to … is required"You have View Only on that page, so Claude can read it but not make that change.
"…your access is limited to your team"Your permissions cover your team only, and that request covers the whole organization.
"You administer several organizations…"You are an admin of more than one organization using this. Contact Toku.
Was this page helpful? Suggest edits