How to Use the 7shifts MCP in Cursor

Q: How do I configure 7shifts inside my Cursor project?

Place an mcp.json file in your project root or home directory. Define the server path there, and Cursor will pick it up automatically.

Write code that interacts with your restaurant's 7shifts data inside Cursor.

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 Cursor

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate rostering with Cursor

Build custom scheduling logic by calling `create_shift` directly from your editor. Your agent can suggest shift changes based on your actual business rules. Stop writing mock data and start testing your scheduling scripts against your real `list_schedules` output.

Query staff records in Cursor

Fetch employee details mid-code by triggering `list_employees`. You get the JSON response instantly in your chat window, ready for your next function. Use `list_roles` to verify permissions and job titles without switching to a dashboard.

Analyze labor logs in Cursor

Pipe your `list_time_punches` data directly into your terminal or script for analysis. It is the fastest way to debug your labor cost calculations. Keep your logic tight by using `list_departments` to filter your data before you process it.

Setup guide

Set up 7shifts MCP in Cursor

Prerequisites

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

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the 7shifts MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent 7shifts transactions." If the MCP tools are loaded correctly, Cursor will call the 7shifts tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.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 Cursor

Place an `mcp.json` file in your project root or home directory. Define the server path there, and Cursor will pick it up automatically.

Yes, enable Agent mode in your chat window. The AI will then suggest and execute tools like `create_employee` to help you manage your workforce.

The server uses your provided API credentials to authenticate with the platform. All communication is authenticated per request, keeping your connection secure.

Your credentials are kept in your local configuration and are never sent to third-party servers. The MCP protocol handles the handshake locally on your machine.

This server processes shift timings, employee contact info, and department structures. Your data is never cached or logged by the client, maintaining strict operational privacy.

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