Integration

Oyster HR integration

Global employment platform API for managing international hiring, payroll, time-off, expenses, and compliance. Enables Employer of Record (EOR) services across 180+ countries, handling employment contracts, benefits enrollment, offboarding, and team member management. Perfect for building global HR integrations, distributed workforce management, and international payroll automation.

Connect Oyster HR How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Oyster HR.Built from the 20 Oyster HR tools below, on the connection you add once.

Common Oyster HR use cases

PTO tracking
approval queue
compensation analysis
PTO requests
global hiring
bonus tracking
company lookup
leave approval
team directory
benefits review

What you can do with Oyster HR

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Expense, 3 operations

approve_expenseApprove expensePOSTApproves a pending expense claim for payment.
create_expenseCreate expensePOSTCreates a new expense claim for reimbursement.
list_expensesList expensesGETLists all expense claims with optional filtering.

Hiring employment, 3 operations

create_hiring_employmentCreate hiring employmentPOSTCreates a new EOR employment for global hiring.
get_hiring_employmentGet hiring employmentGETRetrieves details of a hiring employment in progress.
submit_hiring_employmentSubmit hiring employmentPOSTSubmits a hiring employment for Oyster review and processing.

Time off request, 3 operations

approve_time_off_requestApprove time off requestPOSTApproves a pending time-off request.
create_time_off_requestCreate time off requestPOSTCreates a new time-off request for a team member.
list_time_off_requestsList time off requestsGETLists all time-off requests with optional filtering.

Engagement, 2 operations

get_engagementGet engagementGETRetrieves detailed information for a specific team member engagement.
list_engagementsList engagementsGETLists all team member engagements with filtering and pagination.

Payroll, 2 operations

get_payrollGet payrollGETRetrieves detailed payroll record with full breakdown.
list_payrollList payrollGETLists payroll records with optional filtering.

Allowance, 1 operation

get_engagement_allowancesGet engagement allowancesGETRetrieves allowances configured for a specific engagement.

Bonus, 1 operation

get_engagement_bonusesGet engagement bonusesGETRetrieves bonus payments for a specific engagement.

Company, 1 operation

get_companyGet companyGETRetrieves company profile and organization details.

Cost estimate, 1 operation

get_hiring_employment_cost_estimatesGet hiring employment cost estimatesGETRetrieves annual cost estimates for a hiring employment.

Department, 1 operation

list_departmentsList departmentsGETLists all departments in the organization structure.

Public holiday, 1 operation

list_public_holidaysList public holidaysGETLists public holidays by country and year.

Time off entitlement, 1 operation

list_time_off_entitlementsList time off entitlementsGETLists time-off entitlements and balances for team members.

Use Oyster HR from Claude Code, Cursor or Codex

Connect Oyster HR in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Oyster HR operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Oyster HR

Create your workspace
Sign up free. Nothing to install.
Connect Oyster HR once
Add your Oyster HR connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.

Oyster HR integration FAQ

What can you do with the Oyster HR integration?

LiveContext exposes 20 operations on Oyster HR, covering expense, hiring employment, time off request and engagement. Common uses include PTO tracking, approval queue and compensation analysis.