Harvest
Overview
Section titled “Overview”The Harvest integration connects Monday Morning to your Harvest time tracking account, giving your AI agent access to time entries, budget performance, profitability metrics, and team utilization data. This enables workflows like checking budget burn during sprint planning or reviewing team capacity before assigning work.
Harvest tools are proxied through the Tauri/Rust backend, which communicates with an external Harvest MCP server. No credentials are stored locally — the MCP server handles authentication.
Prerequisites
Section titled “Prerequisites”- A Harvest account with time tracking data
- The Harvest MCP server configured and running
- Monday Morning desktop app or MCP server connected to the Harvest proxy
Step 1: Configure the Harvest MCP Server
Section titled “Step 1: Configure the Harvest MCP Server”The Harvest integration uses an external MCP server rather than a local API token. Follow the Harvest MCP server’s setup instructions to configure authentication with your Harvest account.
Step 2: Connect via Monday Morning
Section titled “Step 2: Connect via Monday Morning”Once the Harvest MCP server is running, Monday Morning’s Tauri backend proxies tool calls to it automatically. No additional configuration is needed in the Monday Morning desktop app.
Step 3: Verify the Connection
Section titled “Step 3: Verify the Connection”Ask your AI agent to list your Harvest projects:
List my active Harvest projectsThe agent will call mm_harvest_list_projects. If configured correctly, you will see your Harvest projects listed.
Available Tools
Section titled “Available Tools”| Tool | Description |
|---|---|
mm_harvest_list_projects | List all projects from Harvest, optionally filtered by active status. |
mm_harvest_list_time_entries | List time entries, optionally filtered by project, user, and date range. |
mm_harvest_aggregate_time | Aggregate time entries, grouped by user, task, or date. |
mm_harvest_compute_budget_performance | Compute budget performance metrics — actual hours versus budgeted hours. |
mm_harvest_compute_profitability | Compute profitability metrics including revenue, costs, and margins. |
mm_harvest_compute_utilization | Compute team or individual utilization rates from time entries. |
Common Workflows
Section titled “Common Workflows”Check budget burn for a project
Section titled “Check budget burn for a project”How much of our budget have we used on the API redesign project?The agent calls mm_harvest_compute_budget_performance to compare actual hours against the budgeted amount.
Review team utilization
Section titled “Review team utilization”What is our team's utilization rate for the past two weeks?The agent calls mm_harvest_compute_utilization with a date range to show how much of available time is being billed.
Get a time breakdown by task
Section titled “Get a time breakdown by task”Show me time entries for this project grouped by task for the past monthThe agent calls mm_harvest_aggregate_time with group_by: "task" and the appropriate date range.
Assess project profitability
Section titled “Assess project profitability”What are the profitability margins on the current project?The agent calls mm_harvest_compute_profitability to calculate revenue, costs, and margin percentages.
Troubleshooting
Section titled “Troubleshooting”“Use the Harvest MCP proxy via Tauri commands” error This means the tool call reached the stub handler instead of the proxy. Ensure the Harvest MCP server is running and that the Tauri backend is configured to proxy Harvest requests.
No projects returned Verify that your Harvest account has active projects and that the MCP server is authenticated with the correct Harvest account.
Time entries missing
Check the date range parameters. By default, some tools may only return recent entries. Use explicit from and to dates to widen the range.
Budget data showing zero Budget tracking must be enabled on the Harvest project. Go to Harvest > Projects > (your project) > Edit and ensure a budget is set.