Shiftbase MCP Server

Approve hours, leave and shift swaps in Shiftbase from your agent.

Server MCP Terhosting

npx add-mcp 'https://cotlet.dev/mcp/v1/shiftbase'

Terpasang ke Claude Code, Codex, Cursor, dan lainnya

Dokumentasi

Cotlet · All integrations · MCP servers · APIs · API & MCP status · How it works · Security · Custom API · For developers · For automation agencies · Blog · API docs · Help center · Changelog · Contact · Pricing · Sign up

Shiftbase MCP server · unofficial, by Cotlet Let your AI agent work in your Shiftbase account.

Cotlet is a cloud browser that stays signed in to your Shiftbase business account, so ChatGPT, Claude or any AI agent can work in it. Free 7-day trial, no card.

Source: https://cotlet.dev/integrations/shiftbase-api-mcp-server

Cotlet is a cloud browser with a remote MCP server. It stays signed in to your Shiftbase business account, so ChatGPT, Claude or any MCP client can work on the same screens you use: schedule, timesheet, absence and reports.

Try it free now

How to connect

  • Free 7-day trial, no card
  • Unofficial, not affiliated with Shiftbase

Server URL

https://cotlet.dev/mcp/v1

Connection

Streamable HTTP · OAuth or API key

Works in

ChatGPT, Claude, Claude Code, Cursor, Codex, n8n

Shiftbase facts on this page were checked on 20 Nov 2026.

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by Shiftbase. Shiftbase is a trademark of its owner. If Shiftbase's own integrations cover what you need, use them first.

Six shift manager jobs

What can you ask your agent to do in Shiftbase? Whatever your own login can do by hand.

  • Lena is off sick tomorrow. Move her shifts to Tom or Sara where they are free.

  • Approve last week's hours that match the schedule, and list the ones that differ by more than 15 minutes.

  • Approve the leave requests for December that leave at least two people per shift.

  • Who worked more than their contract hours this month?

  • Add an open shift on Saturday from 18:00 to 23:00 at the bar.

  • Export last month's worked hours per employee for payroll.

Remote MCP server

How does the Shiftbase MCP server from Cotlet work?

Cotlet runs a remote MCP server that gives your AI agent a Cloud Browser: a Chrome that runs in the cloud and stays signed in to your Shiftbase business account. Your AI client connects to the server and gets browser tools from it. Before its first step in Shiftbase, the agent reads Cotlet's guide to Shiftbase's screens. Then it opens app.shiftbase.com in your Cloud Browser and works on the same screens you use.

  1. YOUR AI ChatGPT, Claude, Cursor, n8n or any MCP client
  2. COTLET MCP SERVER https://cotlet.dev/mcp/v1 Streamable HTTP · OAuth or API key
  3. YOUR CLOUD BROWSER Chrome in the cloud, signed in as you
  4. SHIFTBASE app.shiftbase.com

Shiftbase MCP server from Cotlet

WhatAnswer
Server URL with OAuth sign-inhttps://cotlet.dev/mcp/v1/connect for ChatGPT, Claude, Claude Code and Grok
Server URL with an API keyhttps://cotlet.dev/mcp/v1 for Codex, Cursor, Hermes Agent, n8n and other MCP clients
TransportStreamable HTTP
Tools your agent getsBrowser tools to open, read, click, type, select, fill in forms, scroll, take screenshots and download files, plus a guide to Shiftbase's screens
Where Shiftbase runsYour Cloud Browser, signed in with your own Shiftbase login
What Cotlet storesThe signed-in session, encrypted. No password
StatusUnofficial. Cotlet is not affiliated with Shiftbase

Claude Code

claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1/connect

The same server and the same tools work in any web app you sign in to. Shiftbase is one of them.

Set up once

How to connect Shiftbase to your AI agent Three steps, no code.

You need the owner login of your Shiftbase business account (or a team login with the access you want the agent to have), access to any sign-in code Shiftbase sends you, and a Cotlet account. The free trial gives you 2,000 credits for 7 days, no card.

  1. Step 1

Sign in to Shiftbase

Your business account, in your Cloud Browser. 2. Step 2

Connect your AI agent

Add the Cotlet server to ChatGPT, Claude or another client. 3. Step 3

Ask for a first job

Your agent asks before it publishes, moves or approves.

We never see your Shiftbase password, and published schedules, shift moves and approvals wait for your OK. Who can see your session

On this page

Any MCP client

Connect Shiftbase to your AI agent

Step 1: sign in to Shiftbase in your Cloud Browser

In the Cotlet console, open your Cloud Browser, go to app.shiftbase.com and sign in with your usual email and password. If Shiftbase asks for a code, you enter it there yourself.

You type the password into Shiftbase's own page. Cotlet does not see it and does not store it; it keeps only the signed-in session, encrypted. If Shiftbase signs you out one day, your agent says so and sends you a link to sign in again.

Step 2: connect your AI agent

Pick the AI you already use. ChatGPT, Claude, Claude Code, Codex, Cursor, Grok, Hermes Agent, n8n and other MCP clients all work in the same signed-in Shiftbase account.

ChatGPTchatgpt.com and its apps Claudeclaude.ai and desktop app Claude Codeone terminal command Codexone entry in config.toml Cursorone entry in mcp.json Grokgrok.com connectors Hermes Agentone block in config.yaml n8nMCP Client node Any MCP clientOpenClaw and others

Pick your AI above to see its steps.

How to connect Shiftbase to ChatGPT

Do this on chatgpt.com in your browser. Cotlet then works in the ChatGPT desktop and phone apps too.

  1. Open Plugins in ChatGPT and click Add.
  2. Click Add custom MCP server. Not in the menu? Turn on Developer mode in Settings, Security and login, then come back.
  3. Paste the name Cotlet and the server URL https://cotlet.dev/mcp/v1/connect. Keep Authentication on OAuth.
  4. Tick "I understand and want to continue" and click Create as a plugin.
  5. Click Connect Cotlet. A Cotlet page opens, click Allow access.
  6. In a new chat, type @Cotlet and pick it from the list.
  7. Ask ChatGPT: "Are you signed in to Cotlet through MCP?" Then try a first Shiftbase task: "List tomorrow's Shiftbase schedule by team member."

ChatGPT asks "Allow ChatGPT to use Cotlet?" before some steps. Pick Always allow, or the chat waits for your click. On a Business, Enterprise or Edu workspace, an admin has to allow custom MCP servers first.

How to connect Shiftbase to Claude

  1. Open Connectors in Claude and click Add. In the desktop app it is under Customize, Connectors.
  2. Click Add custom connector.
  3. Paste the name Cotlet and the URL https://cotlet.dev/mcp/v1/connect, then click Continue.
  4. Keep the settings and click Add.
  5. A Cotlet page opens. Click Allow access.
  6. In a chat, click the plus button, then Connectors, and turn Cotlet on.
  7. Ask Claude: "Are you signed in to Cotlet through MCP?", then "Which Shiftbase hours from last week are still waiting for approval?". Claude asks before it uses a Cotlet tool the first time. Click Allow.

Claude's free plan allows one custom connector. On a Team or Enterprise plan, an owner adds Cotlet in Organization settings, Connectors, and you click Connect next to it.

How to connect Shiftbase to Claude Code

Add Cotlet without a key, then sign in once in the browser:

claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1/connect

Run /mcp in Claude Code, pick cotlet and sign in to Cotlet. Prefer an API key, for example on a server? Create one in the Cotlet console and use:

claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 \
  --header "Authorization: Bearer $COTLET_API_KEY"

How to connect Shiftbase to Codex

Create an API key in the Cotlet console, put it in the COTLET_API_KEY environment variable and add this to ~/.codex/config.toml:

[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"

How to connect Shiftbase to Cursor

Create an API key in the Cotlet console, put it in the COTLET_API_KEY environment variable and add this to ~/.cursor/mcp.json:

{
"mcpServers": {
"cotlet": {
"url": "https://cotlet.dev/mcp/v1",
"headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
}
}
}

How to connect Shiftbase to Grok

Grok takes custom MCP servers on grok.com, per xAI's connectors documentation (checked 8 November 2026).

  1. Open grok.com/connectors and click New Connector.
  2. Pick Custom and paste the server URL https://cotlet.dev/mcp/v1/connect.
  3. Sign in to Cotlet when Grok asks, then click Allow access.
  4. Ask Grok: "Are you signed in to Cotlet through MCP?"

On Grok Business, an admin adds the connector first in the xAI console, under Grok Business, Connectors. The Grok chat inside X has no custom connector menu.

How to connect Shiftbase to Hermes Agent

Add Cotlet to ~/.hermes/config.yaml in the format of the Hermes MCP config reference:

mcp_servers:
cotlet:
url: "https://cotlet.dev/mcp/v1"
headers:
Authorization: "Bearer ${COTLET_API_KEY}"
trust: untrusted

Put COTLET_API_KEY in ~/.hermes/.env and check it with hermes mcp test cotlet. With trust: untrusted, Hermes runs reads at once and asks before every write. More on Hermes in our post on the Hermes Agent browser.

How to connect Shiftbase to n8n

Use the MCP Client node, or the MCP Client Tool inside an AI Agent node:

  • Server Transport: HTTP Streamable
  • MCP Endpoint URL: https://cotlet.dev/mcp/v1
  • Authentication: Bearer Auth, with your Cotlet API key as the token
  • Tools: let the AI Agent node use Cotlet's browser tools; it reads Cotlet's Shiftbase guide first and works in your signed-in Shiftbase account

Use it for work that should run on its own, such as a Monday list of Shiftbase hours that differ from the schedule, for you to approve.

Any other MCP client

Point the client at https://cotlet.dev/mcp/v1 over Streamable HTTP, with the header Authorization: Bearer <your Cotlet API key>. A client that supports OAuth sign-in can use https://cotlet.dev/mcp/v1/connect instead and needs no key. The full reference is in the MCP docs.

Step 3: ask for a first job

Pick one job you did by hand this week, ask for it, and check the result in your Shiftbase schedule. For example: "Lena is off sick today. Move her shifts to whoever is free at the same time, list the ones nobody can take, and ask me before each change." Your agent asks you before it publishes a schedule, moves a shift or approves hours or leave.

No official MCP found

Does Shiftbase have an MCP server? No Shiftbase MCP server was found.

No Shiftbase MCP server or ChatGPT or Claude app was found on shiftbase.com, and the official MCP Registry lists none from Shiftbase (checked 20 Nov 2026).

  • Shiftbase API tokens come with App Center+, an add-on at €20 a month, and you write the code.
  • Cotlet works in your signed-in Shiftbase account, on the Schedule, Timesheet and Absence screens.
  • The full picture with sources: Does Shiftbase have an API or MCP server?

0/3

Official MCP server

None found

Full API & MCP report

Checked 20 Nov 2026. Sources: Shiftbase pricing and add-ons · MCP Registry search

Your login, your screens

Which Shiftbase screens can your agent work in?

Your agent works on the screens your Shiftbase login opens. An owner sees everything. A team member sees what their permissions allow.

Screen

Shiftbase screens your agent can work in

Examples of what you can ask for

  • Schedule

    • Shifts for a day or week
    • a move or an open shift
    • publishing after your OK
  • Timesheet

    • Worked hours against the schedule
    • approvals after your OK
  • Absence

    • Leave and sick days
    • requests you approve
  • Employees

    • Contract hours
    • teams and contact details
  • Reports

    • Hours
    • costs and absence for any period
    • as Excel or CSV

Want the same jobs as API endpoints for n8n, Make or your own code? See Shiftbase API with Cotlet.

Encrypted, revocable

Who can see my Shiftbase session, and how do I stop it?

Security overview

  • What Cotlet keeps

Your signed-in Shiftbase browser profile, encrypted with AES-256-GCM, in Finland. No password.

  • What your agent sees

The same pages your Shiftbase login shows. Nothing more.

  • When Shiftbase signs you out

You get an email with a link and sign in again yourself.

  • How to stop it

Disable Shiftbase for agents, reset the browser or delete the key, in the Cotlet console.

A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory (live results).

Asks first

Your agent asks before it changes anything Your team sees nothing new until you say yes.

  1. 1

Finds the shifts

Every shift of the person who is out. 2. 2

Checks who is free

Same time, same team, within contract hours. 3. 3

Asks for your OK

Before it publishes a schedule, moves a shift or approves hours or leave. 4. 4

Shows the moves

Shift by shift, before it publishes.

Your agent asks you before it publishes a schedule, moves a shift or approves hours or leave. Draft shifts and notes are only seen by your team. Check each change in your Shiftbase schedule.

Which Shiftbase actions can be undone

ActionUndo
Publish a scheduleNot from Cotlet. Check Shiftbase's own rules before you allow it
Approve hours or leaveNot from Cotlet. Check Shiftbase's own rules before you allow it
Move a shiftCheck it in the Shiftbase schedule after the change
Add an open shift, a noteCheck it in Shiftbase after the change

Pay as you go

What does Cotlet cost?

Full pricing

  • From $29
    one-time pack of 5,000 credits, valid for 365 days, no subscription
  • 50 credits
    a day of Cloud Browser for agents
  • 5 credits
    a minute of agent work
  • 7 days
    free trial with 2,000 credits, no card

Cotlet credit packs: price and credits

CreditsPrice, one timePer 1,000 credits
5,000$29$5.80
15,000$79$5.27
32,000$149$4.66
60,000$249$4.15

Cotlet is best for cafe, shop and care managers on Shiftbase who want ChatGPT or Claude to fill gaps, approve hours and pull payroll numbers without building on the API.

  • No App Center+ add-on or developer needed

EU company, since 2019

Who runs Cotlet A company you can look up.

About us

Cotlet is run by Take Group sp. z o.o., a software company registered in Poland, EU (VAT PL6342984273), working since 2019. The founders are Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Questions about Shiftbase on Cotlet go to contact@cotlet.dev.

Company

Take Group sp. z o.o.

Registered

Poland, EU

VAT

PL6342984273

Working since

2019

Founders

Bart Krawczyk and Jake Slugocki

Shiftbase and AI agents: questions

Is this an official Shiftbase integration?

No. Cotlet is independent and not affiliated with Shiftbase. Your agent works through your own signed-in Shiftbase account, the way you would by hand.

Do I need App Center+?

Not for Cotlet. Shiftbase API tokens come with App Center+; Cotlet works in your signed-in Shiftbase account instead.

Will my team get notified?

Nothing changes before your OK. Shift moves, published schedules and approvals wait for you; what Shiftbase tells your team after a change follows your own Shiftbase settings.

What can the agent not do in Shiftbase?

Your agent cannot do more than your own Shiftbase login. Payroll exports to your accountant, contracts and billing are jobs to keep in your own hands.

Can I use Shiftbase with n8n?

Yes. n8n connects to Cotlet with its MCP Client Tool and a Cotlet API key, and runs the same jobs on a schedule.

More scheduling apps on Cotlet

  • HR & recruiting

Deputy

Approve timesheets and leave, and roster shifts in Deputy.

  • HR & recruiting

Quinyx

Approve requests, offer open shifts, attest hours and publish Quinyx schedules.

  • Productivity & teams

Connecteam

Approve timesheets, publish shifts, answer time off and create tasks in Connecteam.

Give your agent a seat at your Shiftbase schedule

Sign in once, connect ChatGPT or Claude, and hand over the first job today.

Try it free now

No card. Takes about 5 minutes.


Give your AI agents your signed-in browser.

Product: Integrations · MCP servers · APIs · API & MCP status · How it works · Pricing · Security · Custom API

Resources: Blog · API docs · Help center · Changelog · GitHub

Solutions: For developers · For automation agencies

Company: About · AI info: company facts · Contact

Legal: Terms of service · Privacy policy · Refund policy · Acceptable use · Cookie policy · DPA · Subprocessors

Elsewhere: Status page · Cotlet on GitHub · Cotlet on X · Cotlet on LinkedIn · Cotlet on Product Hunt · Cotlet on Crunchbase · Cotlet on SaaSHub

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. About us

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.