Integration · Payroll & HR

Connect Claude & ChatGPT to Oyster

Ask your AI which time off requests are waiting, which expenses need review, or what payroll changes were made this month in Oyster. It can list and read engagements, time off, time sheets, expenses, payroll changes, payrolls, payslips, documents and invoices, and approve or decline requests. Routine HR admin can be handled from the chat.

Connect Oyster free

Free plan, no credit card. Takes about a minute.

Try asking

“Which time off requests are waiting for me?”
The AI lists time off requests with team member, type, dates and status.
“Approve Maria's vacation request for 10 to 14 March.”
It finds the request and approves it. Maria is notified.
“Which expenses are still waiting for review?”
It lists expenses filtered by review state, with amount and category.

What your AI can do

Team and time off

List engagements, departments, documents and payslips, read entitlements and public holidays, and create, approve or reject time off requests.

Expenses and time sheets

List and read expenses and time sheets, submit expenses, approve or decline expenses and approve time sheets.

Payroll and invoices

List payrolls and payroll changes, add changes such as bonuses, and read Oyster invoices with amounts, status and due date.

“Add a 500 EUR bonus for Tom in the June payroll.”
It finds Tom's engagement and adds a payroll change for June with the amount and currency.
“How many vacation days does the team have left?”
It lists time off entitlements with allowances and balances for your team members.
“Which public holidays are there in Germany in December?”
It lists the public holidays for that country in that date range.

27 tools for Oyster

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

approve_expenseVisible to othersApprove an expense by `expense_id` so it is reimbursed to the team member through Oyster.
approve_time_off_requestVisible to othersApprove a pending time off request by `request_id`. The team member is notified.
approve_time_sheetVisible to othersConfirm (approve) a submitted time sheet by `time_sheet_id`.
create_expenseChanges dataSubmit an expense for an engagement. Needs `engagement_id`, `name`, `category`, `incurred_on` (date), `receipt_url` and `receipt_amount` (decimal and currencyCode).
create_payroll_changeChanges dataAdd a payroll change (such as a bonus) for an engagement in a given payroll `year` and `month`. Needs `engagement_id`, `type` and `amount` (decimal and currencyCode). It changes what the team member is paid.
create_time_off_requestChanges dataCreate a time off request for an engagement. Needs `engagement_id`, `type` (VACATION, SICK_LEAVE, UNPAID_LEAVE, OTHER), `reason`, `start_date`, `end_date` and `request_by_admin` (true when you as admin request it).
decline_expenseVisible to othersDecline an expense by `expense_id`, optionally with a `reason`. The team member is notified.
get_companyGet your Oyster company's details. Use to confirm which company you are working in.
get_engagementGet one engagement (team member) by its ID, passed as `project_id`, with role, country, dates and pay details.
get_expenseGet one expense by `expense_id`, with amount, category, receipt and review state.
get_invoiceGet one Oyster invoice by `invoice_identifier`, with amounts, status and due date.
get_payroll_changeGet one payroll change by `payroll_change_id`.
get_time_off_requestGet one time off request by `request_id`.
get_time_sheetGet one time sheet by `time_sheet_id`, with its entries and status.
list_departmentsList the departments in your company.
list_engagement_documentsList the documents (such as contracts) of one engagement by `engagement_id`.
list_engagement_payslipsList the payslips of one engagement by `engagement_id`.
list_engagementsList engagements (your team members, employees and contractors hired through Oyster). Page with `page` and `limit`. Use to find an engagement ID.
list_expensesList expenses, optionally searched with `query` or filtered by `review_states`. Page with `page` and `limit`.
list_invoicesList Oyster invoices, filtered by `statuses`, `types`, `engagement_ids` or an issue date range (`issue_date_from`, `issue_date_to`).
list_payroll_changesList payroll changes (bonuses, allowances and other one-off pay items), filtered by `engagement_id` or a `from`/`to` date range.
list_payrollsList payroll runs, optionally within a `from`/`to` date range.
list_public_holidaysList public holidays between `start_date` and `end_date`, for a `country_code` (and optional `subdivision_code`) or for an `engagement_id`.
list_time_off_entitlementsList time off entitlements (allowances and balances) for your team members.
list_time_off_requestsList time off requests, optionally only for some `engagement_ids`. Page with `page` and `limit`.
list_time_sheetsList time sheets submitted by team members. Page with `page` and `limit`.
reject_time_off_requestVisible to othersReject a pending time off request by `request_id` with a `reason`. The team member is notified.

Set up in three steps

1
Pick the app
Create a free PipMCP account and choose Oyster from the app list.
2
Paste your key
Create your own Oyster Developer App, paste its app code, Client ID and Client secret, then sign in with Oyster once. You need Company Admin access. In Oyster open the Developer tab and create a new Developer App with the Redirect URL https://pipmcp.com/oauth/callback and the scopes you need (read, manage). Copy the Client ID and Client secret from the popup, as the secret is not shown again. On the Developer Applications page copy the Authorization URL and paste the code at its end, after /oauth/authorize/, as your app code.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in Oyster?

It can list and read engagements, departments, documents, payslips, time off requests and entitlements, public holidays, time sheets, expenses, payroll changes, payrolls and Oyster invoices. It can create time off requests, expenses and payroll changes, approve or reject time off requests, approve or decline expenses and approve time sheets.

Does the AI see my Oyster credentials?

No. Your Client ID, Client secret and sign-in tokens are are encrypted at rest and never shown to the AI. After you save them, they are not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start with lookups only. An approved expense is reimbursed, a payroll change changes what a team member is paid, and approvals and rejections notify the team member, so those tools can require your approval before they run. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT, open Settings › Apps & Connectors › Advanced, turn on Developer mode and add your PipMCP link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

Oyster connects with OAuth, and OAuth connections need the PipMCP Pro plan or above. PipMCP also has a free plan with no credit card, but it does not include this connection. Paid plans bill per completed task. You also need your own Oyster account.

What is an engagement?

In Oyster an engagement is a team member hired through Oyster, either an employee or a contractor. Most tools need its ID. You do not have to look it up: the AI lists your engagements first and picks the right one, or asks you if it is unclear.