Planerio MCP by usefulapi

io.usefulapi由 usefulapi.io 發布官方發布者v1.0.0更新於 Nov 14, 2026

Read shifts, staffing requirements, staff, employees, absences and vacation days in Planerio.

發布方自己的服務:Ably MCP by usefulapi

已驗證Streamable HTTP可網頁執行效率與工作流商業與電商

概覽

AI 產生的概覽

託管的 Planerio 連接器,讓助理讀取排班、人力需求、可用人員、員工資料、缺勤與年假天數。

可以做什麼
  • 依日期區間列出已排班次,含員工、工作地點、位置、標籤與最後變更
  • 列出定義人力需求的班次卡,含所需資格與預排員工
  • 列出可用人力與員工主檔,如班次組、工時安排、主管與成本中心
  • 列出缺勤區間及狀態與類型,並依員工查詢某年度年假額度
  • 查看本月工具呼叫用量、提出功能需求,以及管理或取消付費方案
適用情境
適合用自然語言向助理詢問 Planerio 排班狀況,例如下週誰上夜班、誰請假、12 月哪些班次組仍有人力缺口。
執行需求
遠端 MCP 端點,無需本機安裝。透過 OAuth 登入;首次連線需提供 Planerio 位址、技術登入使用者名稱與密碼,以及由 Planerio 管理員建立的班次組權杖。用戶端設定中不填任何金鑰。免費方案每月 50 次工具呼叫。
安裝前請注意
涉及員工個人資料,包括出生日期與聯絡方式,應只依任務需要索取。中繼工具可透過付款連結開通付費訂閱、變更方案並立即收取差額,或取消訂閱且當期不退款。Planerio 憑證與班次組權杖於登入時輸入並依使用者儲存。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Planerio MCP by usefulapi,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.usefulapi%2Fplanerio/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "planerio-by-usefulapi": {
      "type": "http",
      "url": "https://planerio.usefulapi.io/mcp"
    }
  }
}

README

Planerio MCP by usefulapi

Use your Planerio account from Claude, Cursor, or any MCP client. Read shifts, staffing requirements, staff, employees, absences and vacation days. Hosted, no local install: connect with your own credentials.

Live endpoint: https://planerio.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://planerio.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http planerio https://planerio.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "planerio": {      "url": "https://planerio.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Planerio credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/planerio/

On first connect you provide the Planerio address (the part before .planer.io, for example example), the Technical login: user and Technical login: password from your Planerio account manager, and the Shift group token that a Planerio admin creates in Admin, Einstellungen, box Planerio-Schnittstelle. The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
planerio_list_shiftsreadList shifts
planerio_list_shift_cardsreadList staffing requirements (shift cards)
planerio_list_staffreadList available staff (resource planning)
planerio_list_employeesreadList employees (master data)
planerio_list_absencesreadList absences
planerio_get_vacation_daysreadGet vacation budget
planerio_usage_statusmetaUsage status (free-tier meter)
planerio_request_featuremetaRequest a missing feature
planerio_upgrademetaUpgrade to Pro or Pro+
planerio_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)10,000 tool calls / month
Pro+ (per user)$39/mo or $390/yr (2 months free)100,000 tool calls / month

Each paid plan covers this server only. Ask your AI to run planerio_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with planerio_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with planerio_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

來源:servers/planerio/README.md,提交 6d32263

工具

6

planerio_list_shifts

List shifts

List the planned shifts between two dates: shift id, start and end time, employee (name, personnel number, employee_uuid), shift group, workplace, location, tags and last change. By default only published plans and no deleted shifts. Use updated_after for changes since a date. Sorted by start time. Read-only. Long lists are cut: use offset to continue.

輸入參數limitoffsetend_date必填start_date必填updated_afterinclude_draftsinclude_deletedinclude_comments

planerio_list_shift_cards

List staffing requirements (shift cards)

List the staffing requirement defined in shift cards: workplace, location, shift group, validity, weekdays, times, shift type, required qualifications and the shifts of each card with priority and pre-planned employee. Filter by validity dates. Read-only.

輸入參數limitoffsetend_datestart_date

planerio_list_staff

List available staff (resource planning)

List the current staff supply for resource planning: name, personnel number, primary shift group, qualifications, weekly hours and days, hours per weekday, entry and exit date. Use it together with planerio_list_shift_cards. For plain employee master data use planerio_list_employees. Read-only.

輸入參數limitoffset

planerio_list_employees

List employees (master data)

List the employee master data valid on a reference date: employee_uuid, names, email, personnel number, shift groups, entry and exit date, work schedule (weekly hours, job title, tariff), supervisor, cost center, occupational category, date of birth. Personal data: ask only for what the task needs. Read-only.

輸入參數limitoffsetreference_date

planerio_list_absences

List absences

List the absence periods that overlap two dates: employee, dates and times, calendar and working days, status (ACCEPTED, OPEN, REJECTED, DELETED), absence type and comment. By default only approved absences. Use include_open for requests that wait for approval. Read-only. Long lists are cut: use offset to continue.

輸入參數limitoffsetend_date必填start_date必填include_daysinclude_openupdated_afterinclude_deletedinclude_rejectedinclude_recurring

planerio_get_vacation_days

Get vacation budget

Get the vacation days per employee for one year: allowance, carry-over from the last year, expired, requested, approved, taken and remaining. Only for Planerio 1.5 (not 2.0); Planerio replaces this endpoint in 2026/27. Read-only.

輸入參數date必填limitoffset

版本歷史

1
  1. v1.0.0最新Nov 14, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Usefulapi 整合