How to Use the Everhour Time Tracking MCP in Windsurf

Q: How does Windsurf use Everhour Time Tracking to check project budgets?

Windsurf's Cascade agent uses the listprojectswithinbudget and getprojectdetaileddata tools to check the status of your projects. It can run these checks automatically in the background and alert you only when a project is at risk, saving you from manual checks.

Let Windsurf's Cascade agent autonomously manage your Everhour time tracking, check project budgets, and build reports for your team.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Everhour Time Tracking MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Check Project Health Automatically

This server lets Windsurf's Cascade agent monitor your project finances without being asked. You can set a goal like "Alert me to any projects nearing budget limits." Cascade then chains together the right tools to get the answer. First, it runs `list_projects_within_budget` to find projects that are getting close to their caps. For any flagged projects, it automatically follows up with `get_project_detailed_data` and `list_team_time_records` to build a complete picture of where the time and money went. You just get the final report in your IDE.

Run Full Time Audits with Windsurf

Stop auditing timesheets by hand. With this MCP server, you can tell Cascade to "audit the team's time for last week." It starts by getting a high-level summary using `quick_time_tracking_audit`. If it finds anything strange, like unassigned hours or a project with no recent activity, it digs deeper. Cascade will use `list_organization_team_members` to see who's on the team and `list_project_tasks` to check what they should be working on. It does the whole investigation for you.

Keep Your Team Roster in Sync

Use Cascade to keep tabs on who is doing what. It can combine information from multiple sources to give you a clear view of your team's activity. This is more than just a simple data fetch. For instance, Cascade can use `list_organization_team_members` to get a list of everyone in your Everhour account. Then, it can loop through that list, calling `get_everhour_user_metadata` for each person to check their role and permissions. It's a quick way to automate user audits.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "everhour-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 Everhour Time Tracking. 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 Everhour 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 Everhour Time Tracking MCP in Windsurf

Windsurf's Cascade agent uses the `list_projects_within_budget` and `get_project_detailed_data` tools to check the status of your projects. It can run these checks automatically in the background and alert you only when a project is at risk, saving you from manual checks.

Yes. You can ask Windsurf to check active timers. It uses the `get_currently_running_timer` tool to see who is tracking time and on which task, giving you a real-time snapshot of your team's work.

Yes, it connects to your entire Everhour account. Once connected, Windsurf can use tools like `list_tracked_projects` and `list_billing_clients` to interact with any project or client you have set up.

The key is Windsurf's Cascade agent. Other clients make you ask for data step-by-step. With Cascade, you give it a goal, and it chains multiple Everhour tools together on its own to get you the answer without constant prompting.

Your Everhour data is secure. The MCP server only accesses time records, project details, and client lists via your API key. All operations happen in a dedicated, isolated Vinkius sandbox that's destroyed after your request is handled. Your data is never stored.

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