Planerio MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.0.0Updated Nov 14, 2026

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

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableProductivity & Workflow Business & Commerce

Server details

Identifier: io.usefulapi/planerio
Transport: Streamable HTTP
Runtime: Web executable
Trust: Verified
Published: Nov 14, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified that this server's namespace belongs to usefulapi.io, which also runs its endpoint. That identifies the publisher; it does not make the server's tools safe.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.usefulapi%2Fplanerio.svg)](https://sourceweft.com/mcp/io.usefulapi%2Fplanerio?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Hosted Planerio connector that lets an assistant read shifts, staffing requirements, staff, employees, absences and vacation days.

What you can do: List planned shifts between two dates, with employee, workplace, location, tags and change tracking
List shift cards defining staffing requirements, including qualifications and pre-planned employees
List staff supply and employee master data such as shift groups, work schedules, supervisor and cost center
List absence periods with status and type, and get vacation day budgets per employee for a year
Check monthly tool-call usage, request a missing feature, and manage or cancel a paid plan
When to use it: Useful when you want to ask an assistant questions about Planerio workforce scheduling in plain language, such as who works the night shift next week, who is absent, or which shift groups still have open staffing requirements.
Requirements: Remote MCP endpoint, no local install. Sign-in is via OAuth; on first connect you supply your Planerio address, the technical login user and password, and a shift group token created by a Planerio admin. No keys go in the client config. A free tier allows 50 tool calls per month.

Before you install

The server handles personal employee data, including date of birth and contact details, so ask only for what a task needs. Meta tools can start a paid subscription through a payment link, change plans with an immediate price-difference charge, or cancel with no refund for the current period. Planerio credentials and the shift group token are entered at login and stored per user.

Installation

In SourceWeft

Open Planerio MCP by usefulapi in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fplanerio/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "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:

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

Tool	Type	What it does
`planerio_list_shifts`	read	List shifts
`planerio_list_shift_cards`	read	List staffing requirements (shift cards)
`planerio_list_staff`	read	List available staff (resource planning)
`planerio_list_employees`	read	List employees (master data)
`planerio_list_absences`	read	List absences
`planerio_get_vacation_days`	read	Get vacation budget
`planerio_usage_status`	meta	Usage status (free-tier meter)
`planerio_request_feature`	meta	Request a missing feature
`planerio_upgrade`	meta	Upgrade to Pro or Pro+
`planerio_cancel_subscription`	meta	Cancel 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

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.

Source: servers/planerio/README.md at commit 6d32263

Tools

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.

Parameterslimitoffsetend_daterequiredstart_daterequiredupdated_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.

Parameterslimitoffsetend_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.

Parameterslimitoffset

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.

Parameterslimitoffsetreference_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.

Parameterslimitoffsetend_daterequiredstart_daterequiredinclude_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.

Parametersdaterequiredlimitoffset

Version history

v1.0.0LatestNov 14, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 daysRequired25 pts
Auth declaredRequired10 pts
Tools listedRequired15 pts
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts

Finance23 toolsNov 14, 2026

Plan	Price	Limit
Free	$0	50 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