How to Use the 7shifts MCP in Windsurf

Q: How do I connect the 7shifts MCP Server to Windsurf?

Edit your /.codeium/windsurf/mcpconfig.json file. Add the Vinkius endpoint URL under the mcpServers array, then click Refresh in the MCP panel. You can also use the built-in MCP Marketplace inside Settings for a one-click install.

Q: Can Windsurf read my 7shifts restaurant schedules?

Yes. Cascade uses the listschedules and listshifts tools to pull raw schedule data directly into your editor context. It reads the JSON response to understand who works when.

Q: Will Windsurf automatically create 7shifts employee profiles?

Only if you tell it to. Cascade can chain the createemployee tool with other setup tasks, but you always define the initial goal. It won't push data without a prompt starting the sequence.

Let Windsurf Cascade automatically read your restaurant schedules and draft shift updates without manual clicks.

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 Windsurf

Create your Vinkius account to connect 7shifts to Windsurf 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 Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Chain 7shifts MCP Server Actions

Cascade doesn't wait for you to prompt every step. Tell Windsurf to audit labor costs across your restaurant group. It pulls location IDs using `list_locations`, grabs the active schedule with `list_schedules`, and pulls the clock-in records via `list_time_punches`. The agent compares scheduled hours against actual punches on its own. You just watch the output generate in your editor while Cascade figures out the API sequence needed to calculate overtime discrepancies.

Onboard Employees Autonomously

Hiring new staff takes a dozen repetitive steps. You can drop a new hire's details into your workspace and let Cascade handle the rest. It reads the text file, fires `create_employee`, maps them to the correct group using `list_departments`, and assigns their job title with `list_roles`. Nobody needs to click through menus or copy-paste email addresses. Windsurf executes the whole sequence and drops the confirmation IDs right back into your documentation.

Draft Shift Schedules in Your IDE

Building next week's roster usually means staring at a spreadsheet. Instead, give Windsurf your coverage requirements and let it query `list_employees` to find available staff. It drafts the proposed assignments directly in a markdown file for your review. Once you approve the draft, the agent pushes the final roster back to the API. It loops through your approved text and triggers `create_shift` for every assigned block, completely bypassing the web dashboard.

Setup guide

Set up 7shifts MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the 7shifts MCP

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

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my 7shifts payment history." If connected, Cascade will call the 7shifts tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "7shifts-alternative-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 Windsurf

Edit your `~/.codeium/windsurf/mcp_config.json` file. Add the Vinkius endpoint URL under the `mcpServers` array, then click Refresh in the MCP panel. You can also use the built-in MCP Marketplace inside Settings for a one-click install.

Yes. Cascade uses the `list_schedules` and `list_shifts` tools to pull raw schedule data directly into your editor context. It reads the JSON response to understand who works when.

Vinkius manages the connection through an isolated backend. Your IDE just calls the tools, and the managed server queues the requests to keep you under the platform's API thresholds.

Only if you tell it to. Cascade can chain the `create_employee` tool with other setup tasks, but you always define the initial goal. It won't push data without a prompt starting the sequence.

We run every connection in a zero-trust, ephemeral sandbox. When your agent calls `list_time_punches` to calculate labor costs, the data passes through memory and is immediately destroyed. Vinkius never stores your staff's clock-in records.

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