Skip to main content
Glama
Sign In
Shiftbase MCP Server

Shiftbase MCP Server

by cotlet-connect
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

Shiftbase MCP server

Connect Shiftbase to ChatGPT, Claude and any AI agent through Cotlet.dev. Review timesheets, decide leave requests and approve shift swaps in your signed-in Shiftbase account. Actions that affect other people ask for approval by default.

What you can ask

Approve last week's hours without conflicts.

Approve leave that keeps 3 on shift.

Approve swaps under 40 hours a week.

Related MCP server: Eversports Studio Manager MCP Server

Connect in 2 minutes

Get your API key at https://cotlet.dev/app and export it as COTLET_API_KEY.

ChatGPT

Settings → Apps → add connector URL https://cotlet.dev/mcp/v1, then sign in with Cotlet.dev. No API key needed.

Claude Code

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

Cursor

Copy .cursor/mcp.json from this repo into your project:

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

Run it locally (stdio)

This repo is a real MCP server. It speaks MCP over stdio, lists its Shiftbase tools without any key, and forwards every tool call to the hosted Cotlet.dev server. The hosted URL above stays the recommended way. Use this when your client only starts local servers.

Run the included Python module with Python 3.10 or later:

python3 shiftbase_agent.py serve

Or with Docker:

docker build -t shiftbase-mcp .
docker run -i --rm -e COTLET_API_KEY shiftbase-mcp

Tools: shiftbase_guide, shiftbase_status, shiftbase_open, shiftbase_read, shiftbase_click, shiftbase_type, shiftbase_close. Without COTLET_API_KEY a tool call answers: "Set COTLET_API_KEY. Get a key at https://cotlet.dev/app".

Command line

Python 3.10+, with no third-party runtime dependencies. Clone this repository and run:

export COTLET_API_KEY="your-key"
python3 shiftbase_agent.py connect   # ready config for Claude Code, Cursor, ChatGPT
python3 shiftbase_agent.py status    # is Shiftbase ready in your Cotlet.dev account
python3 shiftbase_agent.py guide     # Shiftbase screens and sign-in link
python3 shiftbase_agent.py read      # open Shiftbase, read the page, close the browser
python3 shiftbase_agent.py tools     # list Cotlet.dev tools
python3 shiftbase_agent.py serve     # start the stdio MCP server (same as no argument)

Questions from Shiftbase users

Does this require the Shiftbase Public API token?

No. Cotlet.dev works in your signed-in Cloud Browser account. Sign in to Shiftbase there and enable it for agents.

Which permissions apply?

Your Shiftbase role applies. Approving hours requires timesheet approval rights; exchanges require the Approve exchanges permission.

Is this affiliated with Shiftbase?

No. Cotlet.dev is independent and not affiliated with Shiftbase.

Learn more

More: https://cotlet.dev/integrations/shiftbase-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=shiftbase

Request access: https://cotlet.dev/signup?app=shiftbase&utm_source=github&utm_medium=readme&utm_campaign=shiftbase

Workflows on the hosted integration

The live integration page documents these 13 operations:

  • list_departments

  • list_employees

  • list_shifts

  • list_open_shifts

  • list_timesheet_entries

  • list_absence_requests

  • list_exchange_requests

  • add_worked_hours

  • set_timesheet_status

  • approve_absence_request

  • decline_absence_request

  • approve_exchange_request

  • decline_exchange_request

The local stdio adapter exposes seven browser helpers listed above. These helpers forward to Cotlet.dev; the workflow operations are documented on the hosted integration page.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    • Shiftbase MCP Server and API by CotletA
      dev.cotlet

      Shiftbase MCP server for ChatGPT, Claude and any AI agent: list timesheet entries, approve timesheet entries, approve absence request, decline absence request, approve exchange request, list open shifts, list shifts and add worked hours in your own Shiftbase account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Shiftbase yourself; Cotlet does not store your password and you need no Shiftbase API key. About the official Shiftbase API: Shiftbase has a Public API for employees, schedules, time registration, clocks and reports, but no official MCP server (checked 22 Oct 2026). An admin installs the Public API tile in the App center to get a token, and every integration is code you write and run yourself. Setup and FAQ: https://cotlet.dev/integrations/shiftbase-api-mcp-server

      App AutomationCRMWorkplace & Productivity
      341
      https://cotlet.dev/mcp/v1/shiftbase
    • Connecteam MCP Server and API by CotletA
      dev.cotlet

      Connecteam MCP server for ChatGPT, Claude and any AI agent: list timesheets, approve timesheet, copy previous week, publish shifts, list time off requests, approve time off request, create task and send message in your own Connecteam account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Connecteam yourself; Cotlet does not store your password and you need no Connecteam API key. About the official Connecteam API: Connecteam has a REST API with read and write endpoints, but only on the Expert plan or higher, and its official MCP server only looks up API endpoints and cannot act on your account (checked 20 Oct 2026). Basic and Advanced plans get no API. Setup and FAQ: https://cotlet.dev/integrations/connecteam-api-mcp-server

      App AutomationProject ManagementWorkplace & Productivity
      341
      https://cotlet.dev/mcp/v1/connecteam
    • Deputy MCP Server and API by CotletA
      dev.cotlet

      Deputy MCP server for ChatGPT, Claude and any AI agent: list timesheets, approve timesheet, discard timesheet, list leave requests, approve leave request, decline leave request, list shifts and create shift in your own Deputy account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Deputy yourself; Cotlet does not store your password and you need no Deputy API key. About the official Deputy API: Yes, Deputy has a full REST API, but no official MCP server (checked 20 Oct 2026). Deputy says its API covers nearly all objects and actions and is included in all plans, so an agent needs your own code, an OAuth client and a token for your install. Setup and FAQ: https://cotlet.dev/integrations/deputy-api-mcp-server

      App AutomationCRMWorkplace & Productivity
      361
      https://cotlet.dev/mcp/v1/deputy
    • Quinyx MCP Server and API by CotletA
      dev.cotlet

      Quinyx MCP server for ChatGPT, Claude and any AI agent: list approval requests, approve request, deny request, offer open shift, add absence, create shift, attest worked hours and publish schedule in your own Quinyx account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Quinyx yourself; Cotlet does not store your password and you need no Quinyx API key. About the official Quinyx API: Quinyx has a REST API (checked 22 Oct 2026), but no official MCP server, and the API leaves out the manager's daily work: it cannot approve requests, offer shifts, attest hours or publish a schedule. Credentials are generated by someone with access to Account Settings > Integrations credentials, and a developer has to build the integration. Setup and FAQ: https://cotlet.dev/integrations/quinyx-api-mcp-server

      App AutomationCRMWorkplace & Productivity
      341
      https://cotlet.dev/mcp/v1/quinyx

    Related MCP Servers

    • AestheticsPro MCP Server

      cotlet-connect
      A
      license
      A
      quality
      B
      maintenance
      Connects AestheticsPro accounts to ChatGPT, Claude, and other AI agents through Cotlet, enabling appointment scheduling, client contact access, lead creation, and staff assignment with user approval.
      7
      Elastic 2.0

    • Eversports Studio Manager MCP

      cotlet-connect
      A
      license
      A
      quality
      B
      maintenance
      Enables ChatGPT, Claude and other AI agents to work inside a signed-in Eversports Studio Manager account through Cotlet — viewing studio activities and sign-in lists, signing participants in, pausing or resuming memberships, and emailing invoices, with user approval before any change is saved. It runs as a hosted connector or a local stdio server that forwards tool calls to Cotlet.
      7
      Elastic 2.0

    • CrewNest MCP Server

      cotlet-connect
      A
      license
      A
      quality
      C
      maintenance
      Enables ChatGPT, Claude, and other AI agents to draft estimates, schedule jobs, assign crew members, and review receivables in a user's signed-in business account, requiring approval before actions reach other people.
      7
      Elastic 2.0

    • Weezevent MCP Server

      cotlet-connect
      A
      license
      A
      quality
      C
      maintenance
      Connects users' Weezevent accounts to ChatGPT, Claude, and other AI agents through Cotlet, enabling event, order, attendee, discount-code, invitation, and refund workflows with approval before actions that affect other people.
      7
      Elastic 2.0