How to Use the 7shifts MCP in Claude

Q: How do I set up the 7shifts MCP Server on Claude Desktop?

You add the server configuration to your claudedesktopconfig.json file. Once saved, restart the app, and you will see the scheduling tools available via the hammer icon in your chat window.

Q: Does 7shifts on Claude Desktop let me approve vacation requests?

You can view vacation requests using the listtimeoff tool inside your chat window. While you cannot approve them directly with the current tools, your agent reads the status of every request to help you plan shifts.

Q: How do I filter shift lists by location?

Your agent calls the listlocations tool to find the exact ID for your specific department or venue. It then uses that ID with listshifts to show you only the schedules that matter for that floor.

Run your restaurant schedule directly from Claude Desktop using this MCP Server to connect to your live 7shifts data.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect 7shifts MCP to Claude Desktop

Create your Vinkius account to connect 7shifts to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup 7shifts with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build schedules inside Claude Desktop

The `create_shift` tool lets your agent assign new work shifts to your employees directly from your chat window. You tell Claude Desktop who is working, when, and where, and it writes the shift details straight to your restaurant's roster. Instead of jumping between tabs to check coverage, you can ask your agent to compare requested hours against actual assignments. It pulls the data, flags overlaps, and builds the schedule without you manually typing a single shift.

Manage staff profiles without leaving your chat

The `create_employee` tool adds new staff profiles to your roster using just a name and email. Your agent pulls existing team lists via `list_employees` to prevent duplicate entries before creating the new record. This means onboarding a new hire happens during your regular chat workflow. You paste the hiring email into Claude Desktop, and your agent extracts the details to set up their profile instantly.

Audit labor coverage using this MCP Server

The `list_shifts` tool retrieves scheduled work shifts across your entire restaurant organization. Your agent filters these schedules by specific dates or locations to find gaps in your floor coverage. You can combine this with `list_time_off` to see who is unavailable before you assign new hours. Claude Desktop handles the cross-referencing so you don't accidentally schedule someone who is on vacation.

Setup guide

Set up 7shifts MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The 7shifts MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the 7shifts MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under 7shifts-mcp.

json

{
  "mcpServers": {
    "7shifts-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by 7shifts. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect 7shifts now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about 7shifts MCP in Claude Desktop

You add the server configuration to your `claude_desktop_config.json` file. Once saved, restart the app, and you will see the scheduling tools available via the hammer icon in your chat window.

Yes, you can connect through the browser version of the client. Paste your remote MCP URL into the Integrations settings on claude.ai to access your restaurant roster from any mobile device.

You can view vacation requests using the `list_time_off` tool inside your chat window. While you cannot approve them directly with the current tools, your agent reads the status of every request to help you plan shifts.

Your agent calls the `list_locations` tool to find the exact ID for your specific department or venue. It then uses that ID with `list_shifts` to show you only the schedules that matter for that floor.

Vinkius runs the MCP server in an isolated sandbox, meaning your staff emails and shift times are never stored on external servers. Your credentials stay secure, and data only moves between your chat client and the restaurant platform.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript