Homebase Connector for AI agents.
10 live capabilities
Manage employee shifts and labor costs across multiple locations.
Waiting for input…
Why people use Homebase
Homebase for Real-Time Workforce Management
With this Connector, you just ask your agent for a headcount or a budget update. You get the answer in seconds, letting you stay focused on the actual work.
What Vinkius changes
You get a hands-off way to manage workforce data through plain conversation.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Checking floor coverage during a rush
A store manager asks who is currently on the clock at the cafe to see if they have enough coverage for a sudden rush of customers.
- Real-world use case 02
Planning weekend staffing
An operations lead asks for the shift schedule for next Wednesday to ensure all departments are properly staffed for the upcoming weekend.
- Real-world use case 03
Verifying new hire details
An HR specialist asks for the profile of a new hire to confirm their role and department assignment are correctly logged in the system.
Complete set · 10capabilities
The complete Homebase capability set.
These are the exact actions your AI can choose when you ask it to work with Homebase.
01—04
4 capabilities in this set.
Part of 10 available through Homebase.
- 01 Capability
Get active clock ins
See which employees are currently working at a specific site. This helps you monitor floor coverage in real time.
- 02 Capability
Get employee profile
Get the full details for an individual staff member. This is useful for quickly pulling HR information.
- 03 Capability
Get api profile
Check your current account status and plan details. Use this to see your own account information.
- 04 Capability
List departments
See how a specific location is organized into different teams. This helps you understand the structure of a site.
05—07
3 capabilities in this set.
Part of 10 available through Homebase.
- 05 Capability
List employees
Get a full list of everyone working at a certain location. This makes it easy to see your total headcount.
- 06 Capability
List labor budgets
View the spending limits and configurations for your labor costs. Use this to keep your operations on budget.
- 07 Capability
List locations
Find the unique IDs for all your different business sites. You need these IDs to use most of the other capabilities.
08—10
3 capabilities in this set.
Part of 10 available through Homebase.
- 08 Capability
List defined roles
See the different job titles like Manager or Server at a location. This helps you see the specific roles available at a site.
- 09 Capability
List scheduled shifts
Look at the planned shifts and schedules for your team. This is great for checking upcoming coverage.
- 10 Capability
List timecards
Pull the actual hours worked for a location to check against your goals. Use this to monitor your actual labor spend.
Set up in minutes
One URL. Then ask Homebase to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Homebase from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_jID5HRgsceucoGZffTJIycSRFjXN0d671AVXIfq1/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Homebase, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Homebase for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_jID5HRgsceucoGZffTJIycSRFjXN0d671AVXIfq1/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Homebase URL.
- Step 03
Save and start
Save the connection and enable Homebase in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"homebase": {
"url": "https://edge.vinkius.com/vk_preview_jID5HRgsceucoGZffTJIycSRFjXN0d671AVXIfq1/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Homebase
Open Agent mode in chat and ask: "Using Homebase, help me...". 10 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"homebase": {
"url": "https://edge.vinkius.com/vk_preview_jID5HRgsceucoGZffTJIycSRFjXN0d671AVXIfq1/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Homebase
Ask Copilot: "Using Homebase, help me...". 10 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"homebase": {
"url": "https://edge.vinkius.com/vk_preview_jID5HRgsceucoGZffTJIycSRFjXN0d671AVXIfq1/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Homebase
Open Cascade and ask: "Using Homebase, help me...". 10 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"homebase": {
"url": "https://edge.vinkius.com/vk_preview_jID5HRgsceucoGZffTJIycSRFjXN0d671AVXIfq1/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Homebase
Ask Cline: "Using Homebase, help me...". 10 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add homebase --transport http "https://edge.vinkius.com/vk_preview_jID5HRgsceucoGZffTJIycSRFjXN0d671AVXIfq1/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Homebase
Ask Claude: "Using Homebase, show me...". 10 tools are ready
Where the request belongs
Work Homebase can move forward.
This is for the retail or hospitality owner who's tired of being buried in spreadsheets and wants to know their team's status in seconds.
Store Manager
Checks who is on-site right now to handle floor coverage during a rush.
Operations Director
Monitors labor costs and shift compliance across five different states.
HR Coordinator
Pulls employee profiles and department structures to update company records.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsDeputy
Equip your AI agent to manage employee rosters, track timesheets, and monitor leave requests via the Deputy API.
Humanity
Manage workforce scheduling, employee shifts, and team communication via Humanity. list employees, manage locations, and track shifts directly from any AI agent.
Hubstaff
Analyze timesheets, query organizational lists, and manage team activities via Hubstaff seamlessly from any AI agent.
Dime.Scheduler
Plan field service teams visually with drag-and-drop scheduling that connects to your ERP for real-time resource allocation.
7shifts
Restaurant workforce management. manage employee schedules, time-off, and staff profiles via AI.
Float
Manage team scheduling, project allocations, and time off via AI agents with Float.
Bring your own AI
Change the model, client or framework. Keep Homebase connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Homebase.
The practical details behind the request, access and result.
How does Homebase MCP help with shift management?
It lets you ask your agent to pull up shift agendas and see who is assigned to what. You can check coverage for specific dates without digging through a web portal.
Can I check who is clocked in using Homebase MCP?
Yes, you can get a real-time list of employees currently on the clock at any of your locations. This is great for quick headcount checks during busy hours.
How do I track labor costs with Homebase MCP?
The Connector pulls your labor budget configurations directly. You can ask your agent to compare your current spending against your set limits for any location.
Can Homebase MCP see my employee profiles?
It can pull detailed information for specific employees. This makes it easy to find contact info, roles, or other profile details quickly.
Is Homebase MCP good for multi-location businesses?
It's ideal for multi-site operations. You can list all your business locations and then query specific data for each one using their unique identifiers.
Can I use Homebase MCP to check timecards?
Yes, you can retrieve timecard entries for a specific location. This helps you monitor actual hours worked to ensure your team's time is tracked correctly.
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.
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.
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.
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.
One connection away
Give your agent a direct line to Homebase.
Connect Homebase once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available