How to Use the timeghost MCP in Windsurf

Q: How do I check if the connection to timeghost is working?

Just ask your agent to run checktimeghoststatus. It pings the timeghost API through the server and will tell you if the connection is live.

Let Windsurf's Cascade agent handle your timeghost entries. It finds projects and logs hours, all on its own, right from your IDE.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect timeghost MCP to Windsurf

Create your Vinkius account to connect timeghost to Windsurf — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup timeghost with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Automate Time Tracking Reports

Give Windsurf a high-level goal, like creating a weekly timesheet report. Its Cascade agent gets to work, first using `list_timeghost_projects` and `list_timeghost_tasks` to map out all the available work inside your account. Next, Cascade chains that context to the next step. It can find a specific team member with `list_timeghost_members` and then pull a complete, filtered report of their hours using `list_timeghost_entries`. You don't have to prompt each step; it just figures it out.

Drill Down into Project Details with Windsurf

Stop digging for records manually. Just ask Windsurf to 'get the latest on the Q3-API-Refactor project,' and it will invoke `get_timeghost_project` to fetch the main record instantly. Because Cascade understands context, it won't stop there. It can see you might also need related task info or a specific time log, so it will proactively use `get_timeghost_task` or `get_timeghost_entry` to give you the full picture. You get the answer you need in one shot.

Manage Workspaces and Clients

Before you can bill hours, you need to know where you're working. Have the Cascade agent run `list_timeghost_workspaces` to see all available environments right from your editor. From there, it can fetch a complete client roster using `list_timeghost_clients` so you can confirm you're logging time against the right account. The agent can even run `check_timeghost_status` first to make sure the MCP server is connected and ready to go.

Setup guide

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

mcp_config.json

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

Windsurf's Cascade agent chains the tools for you. Just state your goal, like 'Log 3 hours on the UI-redesign task for Vinkius,' and it automatically finds the right IDs and submits the entry. This MCP server provides the tools; Windsurf creates and executes the plan.

Yes. Ask Windsurf to 'show me all my timeghost projects.' It uses the `list_timeghost_projects` tool to pull that data and display it right in your IDE.

Use the built-in MCP Marketplace. Open the MCP panel in Windsurf, find the timeghost server, and click install. It's the fastest way to get everything connected.

Just ask your agent to run `check_timeghost_status`. It pings the timeghost API through the server and will tell you if the connection is live.

This server only accesses your timeghost data: projects, tasks, clients, and time entries. It runs in a secure V8 isolate sandbox on Vinkius, and all authentication is handled via a single token, so your account credentials are never exposed.

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