How to Use the Hubstaff MCP in Claude Code

Q: How do I add the Hubstaff MCP Server to Claude Code?

Run the command claude mcp add --transport http hubstaff-mcp -- in your terminal. Make sure all flags come before the server name to ensure proper configuration.

Q: How does Claude Code fetch Hubstaff organization details?

The CLI agent executes getorganization or listorganizations to pull your parent company profiles. It outputs these details directly as text in your terminal session.

Q: Is my team's billing data safe when queried via the CLI?

Your billing blocks and temporal records, retrieved using listtimeentries, are transmitted over encrypted HTTPS directly to your terminal. No third party intercepts or retains these financial logs.

Pipe Hubstaff timesheets, task lists, and team activities directly into your terminal workflows with Claude Code.

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 Claude Code

Create your Vinkius account to connect Hubstaff to Claude Code 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 Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Command-Line Timesheet Audits with Claude Code

The Hubstaff MCP Server exposes `list_time_entries` so you can grep, pipe, and analyze team hours directly from your shell. Run a quick query to pull weekly billing blocks and output them as raw JSON or clean terminal tables. You can combine this tool with `list_users` to see who logged hours on specific days. It turns a tedious web-dashboard chore into a fast one-liner.

Headless Task and Project Audits

This MCP Server uses `list_tasks` and `list_projects` to let your CLI agent audit your entire project pipeline. You can run automated cron jobs that query active tasks and flag overdue milestones without opening a browser. It pulls the exact structure of your active projects using `get_project`. This makes it easy to feed project statuses into your deployment scripts.

Track Activity Feeds via Shell

Your terminal agent queries active team work patterns using `list_activities` to output live operational feeds. You can pipe this raw stream into other CLI utilities or trigger alerts when activity drops below a threshold. It resolves user IDs to actual names by calling `get_user` behind the scenes. You get a clear, human-readable log of who is doing what, right in your terminal.

Setup guide

Set up Hubstaff MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see hubstaff-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Hubstaff transactions." It will automatically discover and invoke the available Hubstaff tools.

Terminal

claude mcp add --transport http hubstaff-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
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

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "hubstaff-mcp": {
      "type": "url",
      "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 Claude Code

Run the command `claude mcp add --transport http hubstaff-mcp -- ` in your terminal. Make sure all flags come before the server name to ensure proper configuration.

Yes, because the terminal agent runs headlessly. You can script it to call `list_time_entries` and output the results as part of your weekly build reports.

The CLI agent executes `get_organization` or `list_organizations` to pull your parent company profiles. It outputs these details directly as text in your terminal session.

Yes, the server supports both stdio and SSE transport protocols. You can configure your transport preference during the initial setup command.

Your billing blocks and temporal records, retrieved using `list_time_entries`, are transmitted over encrypted HTTPS directly to your terminal. No third party intercepts or retains these financial logs.

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