Oracle Fusion HCM MCP Server
for AI Agents

Create a new employee with personal and assignment details. PREREQUISITE - First call list_emps with expand=assignments to get LegalEntityId and BusinessUnitId.

PREFERRED employee lookup by name, email, or PersonNumber -- on 403 FORBIDDEN errors, fall back to list_workers which returns the same PersonId -- for salary data use list_salaries, for assignment details use list_emp_assignments, for onboarding tasks use list_worker_journey_tasks

Retrieve a single employee's full profile by GUID (not PersonId) -- requires empsUniqID from list_emps self link

Update an existing employee by PersonId

Creates a new worker record in Oracle Fusion HCM. Requires elevated privileges.

List workers (employees, contingent, pending) -- does NOT include journey/onboarding tasks (use list_worker_journey_tasks separately) or salary data (use list_salaries) -- prefer list_emps for employee-specific queries

Retrieve a single worker by composite ID (PersonId,EffectiveDate) with optional child resource expansion

Update an existing worker record using date-effective processing -- requires Effective-Of header with RangeMode

Create a new assignment for an employee

Get all work assignments for an employee (job, department, manager, salary per assignment) -- requires empsUniqID GUID from list_emps

Retrieve a specific assignment for an employee

Update an existing assignment for an employee

Get organizations (departments, business units, legal employers) -- use ClassificationCode filter to find specific org types

Retrieve a specific organization or department by unique ID from Oracle HCM Cloud

Create a new absence/leave record -- requires personId, legalEntityId, absenceTypeId, dates, and absenceStatusCd (SAVED for draft, SUBMITTED for approval)

List leave/absence records (sick, vacation, parental) with status, duration, and approval info -- filter by personId, legalEntityId, or absenceType

Retrieve a single absence record by personAbsenceEntryId with full details including duration, approval status, and dates

Update an existing absence record -- only SAVED (draft) absences can typically be updated; check absenceUpdatableFlag before calling

Permanently delete an absence record -- only draft/SAVED absences can be deleted; approved absences cannot be removed

Get a list of time records with filtering and pagination options

Retrieve a specific time record by its unique identifier

Get a list of attributes for a specific time record

Retrieve a specific attribute for a time record

Get a list of messages for a specific time record

Retrieve a specific message for a time record

Get a list of message tokens for a specific time record message

Retrieve a specific message token for a time record message

Get a list of salary components for a specific salary record

Retrieve a specific salary component by ID in Oracle HCM Cloud

List active benefit enrollments (health, dental, life insurance) with plan names, coverage amounts, and dates -- filter by PersonId or PlanId

Retrieve a single benefit enrollment with full plan details, coverage amounts, and expandable costs/dependents/providers

List dependents (spouse, children) covered under a specific benefit enrollment -- requires EnrollmentResultId from list_benefit_enrollments

Retrieve a single covered dependent's details (name, relationship, coverage dates) for a benefit enrollment

Create a new recruiting candidate -- Email must be unique across all candidates or Oracle returns error IRC-1590024

List recruiting candidates with contact info, source details, and expandable child resources (education, experience, skills, attachments)

Retrieve a single recruiting candidate by CandidateNumber with full profile, contact info, and expandable child resources

Update a recruiting candidate's personal info, contact details, or nested resources (education, experience, skills) via PATCH

Permanently delete a recruiting candidate by CandidateNumber -- cannot be undone

Create a new job requisition -- requires Title, RecruitingType, HiringManagerId, RecruiterId, StateId, PrimaryLocationId, PhaseId, and UnlimitedOpenings

List job requisitions with title, openings, hiring manager, salary range, department, location, and publishing status

Retrieve a single job requisition with full details including compensation, openings, published job status, and child resources

Update a job requisition's fields (title, openings, compensation, contacts, published status, skills, locations) via PATCH

Permanently delete a job requisition -- returns 204 on success; cannot be undone

List recruiting job offers with candidate, requisition, hiring manager, phase/state, expiration, and hire date details

Retrieve a single job offer with full details including candidate, requisition, phase/state, e-signature instructions, and attachments

Bulk-import performance goals into a goal plan from a mass assignment request -- requires goalPlanId and reviewPeriodId

List employee performance goals with status, percent complete, target dates, and review period -- filter by PersonId or GoalId

Retrieve a single performance goal with full details including status, percent complete, target dates, and associated goal plans

List which goal plans a performance goal belongs to -- returns plan names, review periods, priority, and weight per plan

Retrieve a single associated goal plan record for a performance goal with priority, weight, and review period details

Create a new goal plan for a review period -- requires GoalPlanName, StartDate, and EndDate at minimum

List performance goal plans (annual reviews, development plans) -- returns plan names, date ranges, assignee counts, and review period info

Retrieve a single goal plan with full details including assignees, goals count, and review period configuration

Update a goal plan's name, description, dates, type, or active status via PATCH

Permanently delete a goal plan by GoalPlanId -- returns 204 on success; cannot be undone

Create a new digital learning content item in Oracle Learning Cloud

Get a list of digital learning content items from external providers

Retrieve a specific digital learning content item by learningItemNumber

Update an existing digital learning content item in Oracle Learning Cloud

Creates a new learning assignment record for a learner.

Get a list of learner learning records with filtering and sorting options

Retrieves a specific learning assignment record by its unique composite identifier.

Updates an existing learning assignment record.

Creates a new learning event (instructor-led training) in Oracle Fusion HCM.

Get a list of learning events with filtering and sorting options

Retrieves a specific learning event by its unique ID.

Updates an existing learning event in Oracle Fusion HCM.

Send an xAPI statement to track learner activity in Oracle Learning Cloud

Retrieve an xAPI statement by its statementId from Oracle Learning Cloud

Create a new talent person profile in Oracle HCM Cloud

Get a list of talent person profiles with filtering and sorting options

Retrieve a specific talent person profile by ID from Oracle HCM Cloud

Update an existing talent person profile in Oracle HCM Cloud

Create a new skill section for a talent person profile in Oracle HCM Cloud

Get a list of skill sections for a talent profile

Retrieve a specific skill section from Oracle HCM Cloud

Create a new skill item in Oracle HCM Cloud

Get a list of skill items for a skill section

Retrieve a specific skill item from Oracle HCM Cloud

Update an existing skill item in Oracle HCM Cloud

Delete a skill item from Oracle HCM Cloud

Create a new document record for a person -- when the user specifies a DocumentType (e.g. 'Passport', 'Birth', 'Application'), proceed directly with creation -- do NOT waste calls validating the type via list_document_records unless you have no idea what type to use

Retrieve a paginated list of all document records (passports, visas, licenses, certificates) stored for persons in Oracle HCM

Retrieve a single document record by its DocumentsOfRecordId, including full metadata and optional child resource expansion

Permanently delete a document record and all its associated attachments by DocumentsOfRecordId

Upload a file (base64), web page link, or text note as an attachment on a document record -- response may return null for AttachedDocumentId

Retrieve a paginated list of all file, web page, and text attachments for a specific document record

Retrieve a single attachment's metadata (file name, type, size, dates) from a document record by its unique hash key

Download ONE SPECIFIC attachment by its attachmentsUniqID -- only use this for a single known file; for downloading all or multiple attachments, you MUST use download_document_record_attachments_bulk instead

Uploads a file attachment to a recruiting candidate (e.g., resume, cover letter)

Get all attachments for a recruiting candidate

Retrieves a single attachment from a recruiting candidate

Downloads the file contents of a candidate attachment

Retrieve onboarding, offboarding, and other HR journey tasks for workers -- use this to check task completion status and progress

Retrieve a single journey task's full details by ID -- Status values are INI (not started), DEP (blocked), PENDING (in progress), COMPLETED, EXP (expired)