How to Use the Homebase MCP in Windsurf

Q: How do I add Homebase to Windsurf?

Open your MCP settings file at /.codeium/windsurf/mcpconfig.json. Add the server entry under the mcpServers key, save, and hit refresh in the MCP panel to see your tools.

Q: Can Windsurf automate my Homebase payroll prep?

Yes. You can have the agent pull listtimecards data and cross-reference it with scheduled shifts. It handles the data retrieval so you can focus on the final sign-off.

Q: Does this MCP server work with multiple Homebase locations?

Absolutely. Use listlocations first to identify the correct UUID, then pass that ID into any other tool to scope the data correctly.

Stop switching tabs to check schedules. Let Windsurf handle your Homebase data directly in the editor.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Homebase MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Full shift oversight for Windsurf

Cascade pulls your live schedule and time logs without you leaving the code window. Use `list_scheduled_shifts` to see who's working when, then pair that with `get_active_clock_ins` to see who actually showed up. Windsurf chains these calls automatically. It takes your goal and hits the API to give you a complete picture of your labor status.

Manage locations and staff data

Start by calling `list_locations` to grab your IDs, then dive into specific employee details. `get_employee_profile` returns exactly what you need to verify contact info or roles. This keeps your context window clean. You see only the data relevant to the current shift or department you're investigating.

Analyze labor budgets in real-time

Compare your actual spend against targets using `list_labor_budgets`. It's a quick way to see if your current staffing levels align with your financial goals. Cascade can trigger this during your planning phase. It ensures your logic accounts for real-world constraints before you commit to a schedule.

Setup guide

Set up Homebase 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 Homebase 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 Homebase payment history." If connected, Cascade will call the Homebase tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "homebase-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 Homebase. 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 Homebase 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 Homebase MCP in Windsurf

Open your MCP settings file at ~/.codeium/windsurf/mcp_config.json. Add the server entry under the mcpServers key, save, and hit refresh in the MCP panel to see your tools.

Yes. You can have the agent pull `list_timecards` data and cross-reference it with scheduled shifts. It handles the data retrieval so you can focus on the final sign-off.

Vinkius handles the auth layer, so your tokens stay isolated. The server only touches your employee profiles and shift records when you explicitly request that information.

Absolutely. Use `list_locations` first to identify the correct UUID, then pass that ID into any other tool to scope the data correctly.

The server surfaces the error directly in the Windsurf chat interface. You'll see exactly which call failed so you can adjust your prompt or check your connection.

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