How to Use the Harvest MCP in Windsurf

Q: How do I connect Harvest to Windsurf?

Add the Harvest server configuration to your Windsurf mcpconfig.json file under the mcpServers block. Windsurf Cascade detects the Harvest MCP server immediately, letting you access your client list and time logs.

Q: Can Windsurf update my Harvest client details?

Yes, Windsurf Cascade uses the updateclient tool to modify existing Harvest accounts. Just tell the Windsurf agent what to change and it updates the Harvest database.

Q: Does Windsurf show my active Harvest projects?

Yes, the Windsurf agent runs listprojects to pull all active Harvest jobs. This lets Windsurf match your local code commits to specific Harvest billing codes.

Q: Can I delete a Harvest client profile directly in Windsurf?

Yes, you run deleteclient to remove Harvest profiles inside Windsurf. This action is permanent, so the Windsurf Cascade agent will ask for confirmation first.

Let Windsurf run your Harvest billing cycle by auto-generating draft invoices from tracked hours without you touching a spreadsheet.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Harvest MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Onboard Harvest clients using the Windsurf MCP Server

The `create_client` tool registers new accounts directly in your Harvest billing system for Windsurf Cascade workflows. This Harvest tool handles the initial setup in Windsurf by writing the client name and details directly to your database. You don't have to open a browser tab to add a new account to your Harvest setup in Windsurf. Windsurf lets Cascade chain this Harvest action with other tasks like project mapping. Once Cascade finishes creating the Harvest record, it reads the setup payload and prepares your Windsurf workspace.

Audit Harvest tracked hours before billing with Windsurf

The `list_time_entries` tool pulls every logged hour from Harvest directly into Windsurf Cascade. It retrieves the exact duration, notes, and user IDs associated with each Harvest entry for Windsurf. Windsurf Cascade reads this raw Harvest data to spot missing descriptions or weird hour spikes. You get a clean summary of billable Harvest work inside your Windsurf chat using this MCP connection before any invoice goes out.

Generate Harvest draft invoices instantly in Windsurf

The `create_invoice` tool builds a draft bill in Harvest using the hours Windsurf selects. It maps the tracked Harvest time directly to line items so Windsurf users don't copy-paste data manually. Windsurf Cascade gathers the Harvest project details via `list_projects`, grabs the hours, and creates the draft invoice. This autonomous Windsurf workflow ensures your Harvest billing is always accurate and fast.

Setup guide

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

mcp_config.json

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

Add the Harvest server configuration to your Windsurf `mcp_config.json` file under the `mcpServers` block. Windsurf Cascade detects the Harvest MCP server immediately, letting you access your client list and time logs.

Yes, Windsurf Cascade uses the `update_client` tool to modify existing Harvest accounts. Just tell the Windsurf agent what to change and it updates the Harvest database.

Yes, the Windsurf agent runs `list_projects` to pull all active Harvest jobs. This lets Windsurf match your local code commits to specific Harvest billing codes.

Yes, you run `delete_client` to remove Harvest profiles inside Windsurf. This action is permanent, so the Windsurf Cascade agent will ask for confirmation first.

Your Harvest time entries, client details, and invoices stay inside your local Windsurf environment. Vinkius runs the Harvest MCP server in an isolated sandbox, meaning your raw financial records are never stored or read by third parties.

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