How to Use the Hubstaff MCP in Windsurf

Q: How do I set up the Hubstaff MCP Server inside Windsurf?

Open your /.codeium/windsurf/mcpconfig.json file and add the server configuration under the mcpServers key. Alternatively, use the Settings UI under Cascade to add it with a single click.

Q: Can Cascade automatically update Hubstaff tasks based on my code changes?

Cascade uses listtasks to read what needs to be done. It cannot write or edit tasks directly because this server focuses on read-only lookups and organizational analysis.

Q: How does Windsurf pull Hubstaff team activity feeds?

The agent calls listactivities to pull the global log of what your team is working on. It formats these events directly in your chat sidebar so you do not have to open the web dashboard.

Q: How is my team's activity data protected?

Your raw activity logs, fetched via listactivities, stay inside the secure V8 sandbox. Vinkius handles the authorization token securely, meaning your team's keystroke and mouse-movement percentages are never exposed or stored on external logging platforms.

Let Windsurf and Cascade automatically pull Hubstaff hours, track tasks, and audit team activities without manual prompts.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Hubstaff MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Auto-Audit Timesheets with Cascade

This Hubstaff MCP Server lets Cascade pull live logged hours using `list_time_entries` to build instant budget reports. Cascade takes your prompt, looks at the active project, and pulls the records without you having to ask for each step. You get a clean breakdown of where the hours went. It matches those hours against active team members via `list_users` so you know exactly who is billing what.

Map Projects and Tasks Instantly

This MCP Server exposes `list_projects` and `list_tasks` to give your IDE full visibility into your active work. Cascade reads this structure to map out pending issues and assign them to the right team members. It links tasks back to the parent organization using `get_organization`. You skip the manual lookup and let your editor organize the workspace context for you.

Chain Activity Tracking in Windsurf

Your Windsurf agent monitors real-time work patterns using `list_activities` to flag bottlenecks before they derail your sprint. It correlates these activities with specific developer profiles retrieved through `get_user` to keep workloads balanced. This gives your agent the context it needs to suggest realistic deadlines. No more guessing who has the bandwidth for the next ticket.

Setup guide

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

mcp_config.json

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

Open your ~/.codeium/windsurf/mcp_config.json file and add the server configuration under the mcpServers key. Alternatively, use the Settings UI under Cascade to add it with a single click.

Cascade uses `list_tasks` to read what needs to be done. It cannot write or edit tasks directly because this server focuses on read-only lookups and organizational analysis.

The agent calls `list_activities` to pull the global log of what your team is working on. It formats these events directly in your chat sidebar so you do not have to open the web dashboard.

No, you only need one master token configured in your MCP settings. The server uses this credential to run tools like `list_users` and `get_user` on behalf of your entire workspace.

Your raw activity logs, fetched via `list_activities`, stay inside the secure V8 sandbox. Vinkius handles the authorization token securely, meaning your team's keystroke and mouse-movement percentages are never exposed or stored on external logging platforms.

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