--- title: "Quinyx MCP server for AI agents - actionlake" description: "Give Claude 117 Quinyx actions through one MCP server: collaboration groups, tags. Your agent never holds the credential. 100,000 calls a month free." canonical: https://actionlake.com/connectors/quinyx updated: 2026-10-23 --- Connectors · Work & projects # Quinyx MCP server for AI agents. actionlake is an MCP gateway: one remote MCP server that connects Claude and other MCP clients to Quinyx and the rest of your systems. It gives your agent 117 Quinyx actions (56 reads, 41 writes and 20 that wait for a confirmation) and holds the Quinyx credential itself, so the agent never does. It paces Quinyx's limits and records every call. [Connect Quinyx free](https://actionlake.com/console?start=sandbox) [See pricing](https://actionlake.com/pricing) 100,000 free calls a month. No card, no email, no password: press Start a free sandbox on the next screen and keep the key it shows you. `claude mcp add --transport http actionlake https://connect.actionlake.com/mcp` the first call ``` do { action: "quinyx.mapping_types.list", intent: "check which Quinyx account is connected" } # List existing mapping types that can be used in a request · read · 1 upstream call ``` - 117 actions in one signed file - 56 read look, never change - 41 write create and update - 20 wait for a yes destructive, confirmed first Set up ## Connect Quinyx in three steps. 1. 01 ### Add actionlake to Claude. Run the command once in Claude Code; its consent page can create a free sandbox: 100,000 calls a month, no card. In the Claude app, add a custom connector with the URL below and paste your key on the consent page. Creating a new sandbox from the Claude app is not yet tested by us. `https://connect.actionlake.com/mcp` 2. 02 ### Connect Quinyx. OAuth 2.0, client credentials. Paste the app's client id and secret; actionlake fetches and renews the token, and nobody has to sign in. actionlake stores what you paste write-only, sealed under your tenant's key. - `client_id` Quinyx API v2 client ID: in Quinyx go to Account Settings > Integration credentials > Generate credentials, select… - `client_secret` Client secret of the same Version 2 integration credential - `host` Where your Quinyx lives: your host ``` account { op: "connections.requirements", service: "quinyx" } # free: exactly what to paste, and what is found for you ``` 3. 03 ### Make the first call. Check before a write. Ask in plain words; Claude picks the action. Before anything changes, `check` validates the call and prices it, for free. ``` do { action: "quinyx.mapping_types.list" } # list existing mapping types that can be used in a request · read · 1 upstream call check { action: "quinyx.groups.create", input: { … } } # free: inputs, permissions, cost and confirmations, nothing sent ``` Quinyx at a glance **Sign-in** OAuth 2.0, client credentials. Paste the app's client id and secret; actionlake fetches and renews the token, and nobody has to sign in. **You provide** `client_id` `client_secret` **Setup fields** `host` **Limits we pace to** 300 calls a minute, per connection **API covered** Quinyx API v2 (OpenAPI 3.1)`api.quinyx.com` **Built from** Quinyx's documentation, read 23 October 2026[developer.quinyx.com](https://developer.quinyx.com/_spec/api/v2/specs/quinyx-public-api-v2.json) [developer.quinyx.com](https://developer.quinyx.com/api/v2) **Service file** Version 1.0.0, signed (Ed25519) **Cached reads** 49 of 56 reads, for up to 5 minutes; a write clears what it affects **Shared entities** 3, so ask can line Quinyx up with your other systems **Data** Processed and stored in Sydney, Australia. No US region yet Capabilities ## What an AI agent can do in Quinyx. 117 actions in 40 areas. Every one carries its effect, so a key can allow the reads and hold the rest. - **56** read look, never change - **41** write create and update - **20** destructive wait for a confirmation 1. ### Collaboration groups 14 8 read · 5 write · 1 destructive Get root collaboration group by domain id · Create collaboration group for domain · List collaboration groups for employee · List collaboration groups for group 2. ### Tags 6 3 read · 2 write · 1 destructive Create tag · List tags by external category id · List paginated tags by external category id · Get tag by external category id and external tag id 3. ### Collaboration group labels 5 2 read · 2 write · 1 destructive Create label for domain · List labels by domain · Get label by id · Update label 4. ### Forecast event categories 5 2 read · 2 write · 1 destructive Create forecast event category for the domain · List forecast event categories for group · Get forecast event category · Update forecast event category 5. ### Forecast events 5 2 read · 2 write · 1 destructive Create forecast events for forecast configurations and groups · List forecast events for group · List forecast events for group and its ancestors · Update forecast event 6. ### Group locations 5 2 read · 2 write · 1 destructive Create group location · List group locations · Get group location by group id and location id · Update group location 7. ### Groups 5 2 read · 2 write · 1 destructive List child groups · Create group · Get group by id · Update group 8. ### Mappings 5 2 read · 2 write · 1 destructive Create mapping · List mappings by type · Search mappings by domain and type · Update mapping **32 more areas · 67 actions** - Forecast actual data **4** - Forecast dynamic rules **4** - Forecast raw data **4** - Forecast static rules **4** - Labor standards **4** - Opening hours **4** - Absences **3** - Collaboration group employees **3** - Forecast budget data **3** - Forecast data **3** - Forecast target data **3** - Schedule availability **3** - Calculated forecasts **2** - Collaboration group groups **2** - Forecast aggregated data **2** - Optimal headcounts **2** - Tag categories **2** - Absence schedules **1** - Absence types **1** - Agreements **1** - AI scheduled headcount **1** - Calculated variables **1** - Employees **1** - Forecast calculation events **1** - Forecast event overrides **1** - Forecast predicted data **1** - Labor standard limit rules **1** - Mapping types **1** - Opening hours periods **1** - Optimal headcount settings **1** - Pay periods **1** - Standard variable statistics **1** Top actions ## The Quinyx API, shaped for agents. The ids your agent types, what each does, and the one name it shares with other systems. 9 of Quinyx's 9 action names are shared with at least one other connector, so an agent learns them once. | Action | What it does | Effect | Same name in | | --- | --- | --- | --- | | `quinyx.groups.list_children` List child groups | List child groups. | read | `hr.department.list` 40 connectors | | `quinyx.employees.get_by_badge` Get List of employee information by badge number | Get List of employee information by badge number. | read | `hr.employee.get` 58 connectors | | `quinyx.groups.create` Create group | Create group. | write | `hr.department.create` 32 connectors | | `quinyx.absences.create` Create full-time absence for employee | Create full-time absence for employee. | write | `hr.leave_request.create` 32 connectors | | `quinyx.absence_types.list` List absence types for group and employee in period | List absence types for group and employee in period. | read | `hr.leave_type.list` 23 connectors | | `quinyx.absences.delete` Delete absence for employee | Delete absence for employee. | destructive | `hr.leave_request.delete` 23 connectors | | `quinyx.collaboration_groups.list_roots` Get root collaboration group by domain id | Get root collaboration group by domain id. | read | this connector | | `quinyx.tags.list` List tags by external category id | List tags by external category id. | read | this connector | | `quinyx.tags.create` Create tag | Create tag. | write | this connector | | `quinyx.mappings.list` List mappings by type | List mappings by type. | read | this connector | | `quinyx.mappings.create` Create mapping | Create mapping. | write | this connector | | `quinyx.forecast_data.list` Get uploaded forecast data for a forecast variable, up to 120 days | Get uploaded forecast data for a forecast variable, up to 120 days. | read | this connector | Try it ## Prompts to paste into Claude. Each one names the Quinyx actions it will call, so you know what it reads and what it changes before you send it. 1. Read read List everyone in Quinyx with their department and start date. calls `quinyx.employees.get_by_badge` 2. Write write Create group in Quinyx. Show me exactly what you will send before you save it. calls `quinyx.groups.create` Governance for Quinyx ## Destructive actions wait for a yes. 20 Quinyx actions are destructive. These are all of them: - Delete a group `quinyx.groups.delete` - Delete absence for employee `quinyx.absences.delete` - Delete tag `quinyx.tags.delete` - Delete mapping `quinyx.mappings.delete` - Delete previously uploaded forecast data for a forecast variable `quinyx.forecast_data.delete` - Delete opening hours based on opening hours id `quinyx.opening_hours.delete` - Delete forecast event `quinyx.forecast_events.delete` - Delete group location `quinyx.group_locations.delete` - Delete a labor standard `quinyx.labor_standards.delete` - Delete uploaded raw data and matching calculated forecast `quinyx.forecast_raw_data.delete` - Delete collaboration group with its children `quinyx.collaboration_groups.delete` - Delete previously uploaded actual data and the matching calculated forecast `quinyx.forecast_actual_data.delete` - Delete previously uploaded budget data for a forecast variable `quinyx.forecast_budget_data.delete` - Delete target data for a target configuration, up to 360 days `quinyx.forecast_target_data.delete` - Delete a static rule `quinyx.forecast_static_rules.delete` - Delete a dynamic rule `quinyx.forecast_dynamic_rules.delete` - Delete forecast event category `quinyx.forecast_event_categories.delete` - Remove groups from a collaboration group, optionally including archived collaboration groups `quinyx.collaboration_group_groups.delete` - Delete label `quinyx.collaboration_group_labels.delete` - Remove employees from a collaboration group, optionally including archived collaboration groups `quinyx.collaboration_group_employees.delete` A destructive action runs only with `confirm: true`. Under the `human` policy the agent cannot confirm for itself: the run stops until a named person approves, in the console or from a signed link in an email. The cap on a key is refused before the call is sent, never after. do quinyx.groups.delete confirm_policy: **human** Delete a group? **intent:** the user asked me to delete a group run suspended · waiting for a named person · key _quinyx-agent_ cannot confirm itself In the console, or from an emailed signed link. a key for this connector ``` account { op: "keys.create", name: "quinyx-agent", allowed_actions: ["quinyx.*"], cap_calls: 2000, confirm_policy: "human_for_writes", approval_rules: [ { match: "quinyx.groups.delete", approver: "lead@example.com" }, { match: "quinyx.absences.delete", approver: "lead@example.com" }, { match: "quinyx.tags.delete", approver: "lead@example.com" } ] } ``` Illustrative. Scoped to Quinyx only, capped at 2,000 upstream calls, every write confirmed, and the destructive ones approved by a named person. Cost ## What Quinyx costs on actionlake. Every Quinyx action is one upstream call, the only thing actionlake bills. Searching, `check`, `cost`, `account` and any call Quinyx refused with 401, 403, 429 or a 5xx are free. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000. - 1 upstream call per action all 117 Quinyx actions - 117 actions page each page of a long list is one call - 49 reads can be cached a cache hit costs nothing - 100,000 calls a month, free paid plans from US$49 a month for 250,000 [See pricing](https://actionlake.com/pricing) Action index ## Every Quinyx action. 117 actions by area: the id your agent calls, what it does, and its effect. **Collaboration groups 14** - `quinyx.collaboration_groups.archive` Archive collaboration group write - `quinyx.collaboration_groups.create` Create collaboration group for domain write - `quinyx.collaboration_groups.delete` Delete collaboration group with its children destructive - `quinyx.collaboration_groups.get` Get collaboration group by id read - `quinyx.collaboration_groups.get_by_root_and_employee` Get collaboration group by root id and employee id read - `quinyx.collaboration_groups.list_by_employee` List collaboration groups for employee read - `quinyx.collaboration_groups.list_by_group` List collaboration groups for group read - `quinyx.collaboration_groups.list_children` List child collaboration groups read - `quinyx.collaboration_groups.list_eligible_parents` List eligible parent collaboration groups read - `quinyx.collaboration_groups.list_roots` Get root collaboration group by domain id read - `quinyx.collaboration_groups.list_under_root` List collaboration groups under root read - `quinyx.collaboration_groups.move` Move a collaboration group to a new parent write - `quinyx.collaboration_groups.unarchive` Unarchive collaboration group write - `quinyx.collaboration_groups.update` Update collaboration group write **Tags 6** - `quinyx.tags.create` Create tag write - `quinyx.tags.delete` Delete tag destructive - `quinyx.tags.get` Get tag by external category id and external tag id read - `quinyx.tags.list` List tags by external category id read - `quinyx.tags.list_paged` List paginated tags by external category id read - `quinyx.tags.update` Update tag write **Collaboration group labels 5** - `quinyx.collaboration_group_labels.create` Create label for domain write - `quinyx.collaboration_group_labels.delete` Delete label destructive - `quinyx.collaboration_group_labels.get` Get label by id read - `quinyx.collaboration_group_labels.list` List labels by domain read - `quinyx.collaboration_group_labels.update` Update label write **Forecast event categories 5** - `quinyx.forecast_event_categories.create` Create forecast event category for the domain write - `quinyx.forecast_event_categories.delete` Delete forecast event category destructive - `quinyx.forecast_event_categories.get` Get forecast event category read - `quinyx.forecast_event_categories.list` List forecast event categories for group read - `quinyx.forecast_event_categories.update` Update forecast event category write **Forecast events 5** - `quinyx.forecast_events.create` Create forecast events for forecast configurations and groups write - `quinyx.forecast_events.delete` Delete forecast event destructive - `quinyx.forecast_events.list` List forecast events for group read - `quinyx.forecast_events.query_hierarchy` List forecast events for group and its ancestors read - `quinyx.forecast_events.update` Update forecast event write **Group locations 5** - `quinyx.group_locations.create` Create group location write - `quinyx.group_locations.delete` Delete group location destructive - `quinyx.group_locations.get` Get group location by group id and location id read - `quinyx.group_locations.list` List group locations read - `quinyx.group_locations.update` Update group location write **Groups 5** - `quinyx.groups.create` Create group write - `quinyx.groups.delete` Delete a group destructive - `quinyx.groups.get` Get group by id read - `quinyx.groups.list_children` List child groups read - `quinyx.groups.update` Update group write **Mappings 5** - `quinyx.mappings.create` Create mapping write - `quinyx.mappings.delete` Delete mapping destructive - `quinyx.mappings.list` List mappings by type read - `quinyx.mappings.query_by_domain` Search mappings by domain and type read - `quinyx.mappings.update` Update mapping write **Forecast actual data 4** - `quinyx.forecast_actual_data.create` Upload actual data with maximum 366 rows write - `quinyx.forecast_actual_data.delete` Delete previously uploaded actual data and the matching calculated forecast destructive - `quinyx.forecast_actual_data.list` Get previously uploaded actual data for a forecast variable, up to 120 days read - `quinyx.forecast_actual_data.list_stream` Stream previously uploaded actual data for a forecast variable, up to 120 days read **Forecast dynamic rules 4** - `quinyx.forecast_dynamic_rules.create` Create a new dynamic rule write - `quinyx.forecast_dynamic_rules.delete` Delete a dynamic rule destructive - `quinyx.forecast_dynamic_rules.list` List dynamic rules read - `quinyx.forecast_dynamic_rules.update` Update a dynamic rule write **Forecast raw data 4** - `quinyx.forecast_raw_data.create` Upload actual data with maximum 366 rows write - `quinyx.forecast_raw_data.delete` Delete uploaded raw data and matching calculated forecast destructive - `quinyx.forecast_raw_data.list` Get uploaded raw data for forecast variable, up to 120 days read - `quinyx.forecast_raw_data.list_stream` Stream uploaded raw data for forecast variable, up to 120 days read **Forecast static rules 4** - `quinyx.forecast_static_rules.create` Create a new static rule write - `quinyx.forecast_static_rules.delete` Delete a static rule destructive - `quinyx.forecast_static_rules.list` List static rules read - `quinyx.forecast_static_rules.update` Update a static rule write **Labor standards 4** - `quinyx.labor_standards.create` Create a labor standard write - `quinyx.labor_standards.delete` Delete a labor standard destructive - `quinyx.labor_standards.list` Read labor standards by external optimal headcount id read - `quinyx.labor_standards.update` Update a labor standard write **Opening hours 4** - `quinyx.opening_hours.create` Create opening hours write - `quinyx.opening_hours.delete` Delete opening hours based on opening hours id destructive - `quinyx.opening_hours.list` Get opening hours based on group id read - `quinyx.opening_hours.update` Update opening hours by id write **Absences 3** - `quinyx.absences.create` Create full-time absence for employee write - `quinyx.absences.create_part_time` Create part-time absence for employee write - `quinyx.absences.delete` Delete absence for employee destructive **Collaboration group employees 3** - `quinyx.collaboration_group_employees.create` Associate employees to a collaboration group write - `quinyx.collaboration_group_employees.delete` Remove employees from a collaboration group, optionally including archived collaboration groups destructive - `quinyx.collaboration_group_employees.list` List employee ids in collaboration group read **Forecast budget data 3** - `quinyx.forecast_budget_data.create` Upload budget data with maximum 366 rows write - `quinyx.forecast_budget_data.delete` Delete previously uploaded budget data for a forecast variable destructive - `quinyx.forecast_budget_data.list` Get uploaded budget data for a forecast variable, up to 120 days read **Forecast data 3** - `quinyx.forecast_data.create` Upload forecast data with maximum 366 rows write - `quinyx.forecast_data.delete` Delete previously uploaded forecast data for a forecast variable destructive - `quinyx.forecast_data.list` Get uploaded forecast data for a forecast variable, up to 120 days read **Forecast target data 3** - `quinyx.forecast_target_data.create` Upload daily target data with maximum 366 rows write - `quinyx.forecast_target_data.delete` Delete target data for a target configuration, up to 360 days destructive - `quinyx.forecast_target_data.get` Get target data for a target configuration, up to 360 days read **Schedule availability 3** - `quinyx.schedule_availability.create` Create schedule availability write - `quinyx.schedule_availability.list_by_employee` Get schedule availability by employee id read - `quinyx.schedule_availability.list_by_group` Get schedule availability by group id read **Calculated forecasts 2** - `quinyx.calculated_forecasts.edit` Update forecast configuration and related data write - `quinyx.calculated_forecasts.get` Get the calculated forecast for a forecast variable, ignoring forecast events read **Collaboration group groups 2** - `quinyx.collaboration_group_groups.create` Associate groups to a collaboration group write - `quinyx.collaboration_group_groups.delete` Remove groups from a collaboration group, optionally including archived collaboration groups destructive **Forecast aggregated data 2** - `quinyx.forecast_aggregated_data.create` Upload pre-aggregated data with maximum 366 rows write - `quinyx.forecast_aggregated_data.list` Get aggregated data for a forecast variable, up to 120 days read **Optimal headcounts 2** - `quinyx.optimal_headcounts.calculate` Calculate optimal headcounts for group, excluding limit rules read - `quinyx.optimal_headcounts.calculate_by_id` Calculate optimal headcount by id read **Tag categories 2** - `quinyx.tag_categories.get` Get tag category by external id read - `quinyx.tag_categories.list` List tag categories read **Absence schedules 1** - `quinyx.absence_schedules.list` List absence schedules for group read **Absence types 1** - `quinyx.absence_types.list` List absence types for group and employee in period read **Agreements 1** - `quinyx.agreements.update` Partially update an existing agreement write **AI scheduled headcount 1** - `quinyx.ai_scheduled_headcount.get` Get ai scheduled headcount snapshot read **Calculated variables 1** - `quinyx.calculated_variables.get` Get calculated variable data by external id, up to 120 days read **Employees 1** - `quinyx.employees.get_by_badge` Get List of employee information by badge number read **Forecast calculation events 1** - `quinyx.forecast_calculation_events.query` Calculate event effects for a customer read **Forecast event overrides 1** - `quinyx.forecast_event_overrides.list` List override events for forecast event read **Forecast predicted data 1** - `quinyx.forecast_predicted_data.create` Upload prediction data with maximum 366 rows at the variable resolution write **Labor standard limit rules 1** - `quinyx.labor_standard_limit_rules.list` Read limit configurations by group for a period read **Mapping types 1** - `quinyx.mapping_types.list` List existing mapping types that can be used in a request read **Opening hours periods 1** - `quinyx.opening_hours_periods.list` Get open periods read **Optimal headcount settings 1** - `quinyx.optimal_headcount_settings.list` Get all optimal headcounts for the customer read **Pay periods 1** - `quinyx.pay_periods.get` Get most recent pay period ending before date read **Standard variable statistics 1** - `quinyx.standard_variable_statistics.query` List standard variables read Questions ## The Quinyx MCP server, answered. **Is there a Quinyx MCP server for Claude?** Yes. actionlake is an MCP gateway: a remote MCP server that gives Claude, or another MCP client, 117 Quinyx actions across collaboration groups, tags, collaboration group labels and forecast event categories, through the same eight tools it uses for every other connector. actionlake is independent; it is not made or endorsed by Quinyx. **What do I need to connect Quinyx?** Quinyx API v2 client ID: in Quinyx go to Account Settings > Integration credentials > Generate credentials, select… and Client secret of the same Version 2 integration credential. Plus your host. The free call account { op: "connections.requirements", service: "quinyx" } lists exactly what to paste. **Can an AI agent delete or change things in Quinyx?** Only if its key allows it, and only with an explicit confirmation. 20 Quinyx actions are destructive, including delete a group, delete absence for employee and delete tag. Each runs only with confirm: true. Under the human confirm policy, or an approval rule on the key, the run waits until a named person approves it. **Will an AI agent use up my Quinyx API limit?** actionlake paces every call to the limits in the Quinyx service file: 300 calls a minute per connection. Repeated reads are answered from cache (49 Quinyx actions can be), which never reaches Quinyx. **What does a Quinyx action cost?** One upstream call, the only unit actionlake bills. A list that pages bills one call per page (117 Quinyx actions page). Cache hits, searches, dry runs and calls Quinyx refused with 401, 403, 429 or a 5xx are free. The Free plan includes 100,000 calls a month with no card. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000. **Which Quinyx API does it cover?** The Quinyx API v2 (OpenAPI 3.1) at api.quinyx.com by default, or the base URL set when you connect. It is built from Quinyx's documentation as read on 23 October 2026. 117 actions in 40 areas, each one in the signed service file (version 1.0.0). **Does actionlake keep my Quinyx data, and where?** actionlake processes and stores data in Sydney, Australia; there is no US region yet. Reads may be cached for up to 5 minutes, and a write clears the reads it affects. Each run's request and response is kept, sealed, for your plan's trace window: 1 day on Free, 3 days on Starter, 7 days on Pro, 14 days on Team, 30 days on Business and 30 days on Enterprise. Your Quinyx credential is sealed under your tenant's key, never logged and never returned. Your traffic is not used to train models. **Which AI clients can use it?** Claude Code, tested by us end to end, and the Claude app as a custom connector, tested by us with an existing key. Other MCP clients that support remote servers over Streamable HTTP (MCP revisions 2025-06-18 and 2025-11-25) and OAuth dynamic client registration, or a bearer header, should connect the same way; we have not tested them. Or plain REST, under the same action names. ## More connectors like Quinyx Shares the most action names with - [Workable 7](https://actionlake.com/connectors/workable) - [Pinpoint 5](https://actionlake.com/connectors/pinpoint) - [Deel 4](https://actionlake.com/connectors/deel) - [15Five 4](https://actionlake.com/connectors/15five) - [Remote 4](https://actionlake.com/connectors/remote) - [Recruitee 4](https://actionlake.com/connectors/recruitee) Joins with, on shared entities - [Odoo 3](https://actionlake.com/connectors/odoo) - [Rippling 3](https://actionlake.com/connectors/rippling) - [Planday 3](https://actionlake.com/connectors/planday) - [Gusto 2](https://actionlake.com/connectors/gusto) - [Deputy 2](https://actionlake.com/connectors/deputy) - [IRIS Staffology Payroll 2](https://actionlake.com/connectors/iris-staffology-payroll) Browse - [All Work & projects connectors](https://actionlake.com/connectors/category/work-and-projects) - [All connectors](https://actionlake.com/connectors) - [How actionlake compares](https://actionlake.com/compare) actionlake is independent. It is not made or endorsed by Quinyx; the name is the vendor's own. Counts are from the Quinyx service file, version 1.0.0. ## Give your agent Quinyx today. [Connect Quinyx free](https://actionlake.com/console?start=sandbox) [See pricing](https://actionlake.com/pricing) Start free - 100,000 calls/month, no card. No signup. Hard caps on every key. Cached answers are free. --- Source: https://actionlake.com/connectors/quinyx More: https://actionlake.com/llms.txt