Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use Homebase with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Automate employee scheduling and time tracking via Homebase. manage shifts, locations, and timecards directly from any AI agent.

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 10 capabilities

The complete Homebase capability set.

These are the exact actions your AI can choose when you ask it to work with Homebase.

Capability set01 / 03

01-04

4 capabilities in this set.

Part of 10 available through Homebase.

  1. 01

    Get active clock ins

    List all employees currently clocked in at a specific location

  2. 02

    Get API profile

    Retrieve information about the authenticated user and plan status

  3. 03

    Get employee profile

    Get detailed information for a specific employee

  4. 04

    List defined roles

    List all roles (e.g., Manager, Server) defined for a location

Capability set02 / 03

05-07

3 capabilities in this set.

Part of 10 available through Homebase.

  1. 05

    List departments

    List all departments configured for a location

  2. 06

    List employees

    List all employees for a specific location

  3. 07

    List labor budgets

    Retrieve labor budget configurations for a location

Capability set03 / 03

08-10

3 capabilities in this set.

Part of 10 available through Homebase.

  1. 08

    List locations

    Use this to find the "location_uuid" required for all other capabilities. List all business locations associated with the Homebase account

  2. 09

    List scheduled shifts

    List scheduled shifts for employees at a specific location

  3. 10

    List timecards

    Useful for monitoring actual hours worked. List timecard entries (timesheets) for a specific location

Observed, not estimated

667ms average. Fast in production.

Homebase is checked daily against the live service.

Daily averagePeak 771ms
Aug 20Today
Fastest day
527ms
Slowest day
771ms
14-day trend
Slowing+12%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 10 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Homebase, so you can see the experience inside your AI.

It does not authenticate your account with Homebase. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

Homebase Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_jID5HRgsceucoGZffTJIycSRFjXN0d671AVXIfq1/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Homebase capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "homebase-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_jID5HRgsceucoGZffTJIycSRFjXN0d671AVXIfq1/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions Homebase owners ask.

  • 01

    How do I obtain my Homebase API Key?

    Log in to Homebase as an Owner, ensure you are on the 'All in One' plan, navigate to Settings > API Access, and click Request API Key. Your key will typically be approved within one business day.

  • 02

    Is the Homebase API read-only?

    Yes, as of current documentation, the Homebase public API provides read-only access to locations, employees, timecards, and schedules. Writing data (like creating shifts) must be done through the web dashboard or official POS/Payroll integrations.

  • 03

    How can I see who is currently working?

    Use the get_active_clock_ins capability with your location UUID. It filters current timecards to show only employees who have clocked in but not yet clocked out for the day.

  • 04

    Is the integration secure for managing employee data?

    Absolutely. The integration uses official Homebase Bearer tokens over HTTPS. Your credentials and sensitive employee information are encrypted and stored securely within the Vinkius Cloud infrastructure.

Explore

More in Productivity

Suggestions