MCP Connector for Claude & ChatGPT

What the Plantime MCP connector does

The Plantime MCP (Model Context Protocol) server lets AI assistants like Claude and ChatGPT work with your Plantime workspace on your behalf. Once connected, you can ask the assistant to:

• Read your workspace — organizations, teams, schedules, shift statistics, and timesheets
• Plan shifts — create single shifts, repeat templates across date ranges, copy weeks, or fill a period based on your team's recent schedule rhythm
• Staff shifts — assign or unassign team members, apply or discard suggested assignments, or run the auto-planner to staff open shifts using availability, competencies, and workload
• Manage timesheets — list, review, approve, reject, or recalculate timesheets

Everything happens under your own Plantime account. The connector can only see and change what you can: most planning tools require a manager, admin, or owner role on the team, and timesheet tools also allow employees to view and approve their own timesheets.

Setup

The connector is a remote MCP server with OAuth login — there is nothing to install.

Server URL: https://www.plantime.io/api/mcp/v1

Claude (claude.ai and Claude desktop)

1. Open Settings → Connectors (on a paid Claude plan)
2. Choose Add custom connector
3. Enter the server URL above and confirm
4. Claude redirects you to Plantime to sign in and authorize access
5. The Plantime tools become available in your conversations

Claude Code

claude mcp add --transport http plantime https://www.plantime.io/api/mcp/v1

Then run /mcp inside Claude Code to complete the OAuth login.

ChatGPT

1. Open Settings → Apps & Connectors
2. Choose Create (developer mode) or add the Plantime app from the directory once published
3. Enter the server URL above, select OAuth authentication, and save
4. Sign in to Plantime when prompted to authorize access

Example prompts

• "Which teams do I manage in Plantime?"
• "Show me next week's schedule for the kitchen team, including who's working."
• "Add a bar shift next Tuesday from 16:00 to 23:00 for two people."
• "Copy this week's shifts to the next two weeks."
• "Automatically assign people to all open shifts in the first week of July."
• "Show me pending timesheets and approve the one for Maria if the hours look right."

Data access and security

• Authorization uses OAuth: you sign in to Plantime directly, and the assistant receives a scoped access token. Your Plantime password is never shared with the assistant.
• All actions are permission-checked server-side against your account's roles, exactly like the Plantime web app.
• Destructive actions are conservative: shift deletion is a soft delete with a one-hour undo window (undo_delete_shifts), and approved timesheets cannot be recalculated.
• You can revoke access at any time by removing the connector from Claude or ChatGPT.

Troubleshooting

"Unauthenticated" or 401 errors — your session expired. Remove and re-add the connector, or use the assistant's reconnect option to sign in again.

The assistant can't see a team or organization — the connector only shows workspaces your Plantime account belongs to. Planning tools additionally need a manager, admin, or owner role on that team.

Date ranges behave unexpectedly — range ends are exclusive for most tools: to include all of June 15th, pass June 16th at 00:00 as the end. Dates are interpreted as ISO 8601 date-times.

A deletion needs to be reverted — ask the assistant to undo it. Deletions return an undo reference that works for one hour. After that, restore shifts by recreating them.

Tools are listed but calls fail — verify your Plantime account works in the web app at plantime.io first; the connector has exactly the same permissions.

Support

If you're stuck, contact us at support@plantime.io or visit the support page. Include the prompt you used and the error message shown by the assistant — that's usually enough for us to pinpoint the issue.