How to Use the GitScrum Time Tracking MCP in Windsurf

Q: How do I connect GitScrum Time Tracking to Windsurf for better focus?

Add the server configuration to your mcpconfig.json file. Once connected, Windsurf automatically detects the available tools, allowing you to track time using natural language commands.

Q: Can Windsurf trigger GitScrum Time Tracking timers during my coding session?

Yes. Cascade can invoke starttimer based on your project goals. It knows exactly which task UUID to target, ensuring your time logs remain precise.

Q: Does GitScrum Time Tracking in Windsurf handle manual log corrections?

It does. If you forget to start a timer, use logmanualtime to record your hours retroactively. You can also use deletetimeentry if you make a mistake.

Track GitScrum time and manage project budgets directly inside Windsurf with automated tool chaining.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect GitScrum Time Tracking MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Chain tasks with Windsurf and GitScrum Time Tracking

Cascade doesn't just read data; it executes complex workflows. You can ask Windsurf to identify `stuck_tasks` and trigger a `start_timer` sequence for the most critical item without manual intervention. It connects your current coding context to your project backend. By using `my_today_tasks`, the agent pulls your actual workload into the editor and maintains accurate records of your progress.

Monitor budget burndown in your IDE

Keep an eye on project health while you write code. Windsurf uses `budget_overview` and `projects_at_risk` to surface potential issues before they hit your delivery timeline. If you need to adjust your focus, use `stop_timer` to finalize your current entry before switching to a new task. The integration ensures every minute spent is captured against the right project ID.

Real-time productivity insights

Get deep visibility into your velocity without leaving your workspace. The agent runs `productivity_report` and `time_analytics` to generate snapshots of your team's output over any period. Stop digging through web dashboards. Let the MCP server pull `standup_summary` data directly into your chat, giving you a clear view of blockers and completed items the moment you start your session.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "gitscrum-time-tracking-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 GitScrum. 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 GitScrum Time Tracking 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 GitScrum Time Tracking MCP in Windsurf

Add the server configuration to your `mcp_config.json` file. Once connected, Windsurf automatically detects the available tools, allowing you to track time using natural language commands.

Yes. Cascade can invoke `start_timer` based on your project goals. It knows exactly which task UUID to target, ensuring your time logs remain precise.

It does. If you forget to start a timer, use `log_manual_time` to record your hours retroactively. You can also use `delete_time_entry` if you make a mistake.

Your data stays within your GitScrum account. The MCP server acts as a secure bridge, only passing the specific task and time information you authorize during your session.

Absolutely. The server only accesses your project task lists and time logs. It never touches your source code or personal files, keeping your environment isolated and secure.

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