MCP server for Harvest time tracking API - use with Claude Desktop and other AI assistants
概览
Connect your AI assistant to Harvest time tracking. Query time entries, analyze profitability, track utilization, and manage your Harvest data through natural language. 1. Open Claude Desktop → → 2. Click 3. Enter: https://harvest-mcp.southleft.com/mcp 4. Click On first use, you'll receive an OAuth link to connect your Harvest account. Add to ~/Library/Application Support/Claude/claude_desktop_config.json: "Show me all my time entries from last week" "How many hours did I log on the Acme project this month?" "Start a timer for the Design task on Project X" "Who on my team logged the most hours last month?"
README
以下为原文 README 节选，完整内容请查看原文。
Harvest MCP Server
Connect your AI assistant to Harvest time tracking. Query time entries, analyze profitability, track utilization, and manage your Harvest data through natural language.
Live Server: https://harvest-mcp.southleft.com
Quick Start
Claude Desktop (Recommended)
- Open Claude Desktop → Settings → Connectors
- Click Add Connector
- Enter:
https://harvest-mcp.southleft.com/mcp - Click Connect
On first use, you’ll receive an OAuth link to connect your Harvest account.
Claude Code CLI
claude mcp add --transport http harvest https://harvest-mcp.southleft.com/mcp
Manual Configuration
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"harvest": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://harvest-mcp.southleft.com/mcp"]
}
}
}
Example Prompts
Time Tracking
“What did I work on today?”
“Show me all my time entries from last week”
“How many hours did I log on the Acme project this month?”
“Start a timer for the Design task on Project X”
“Stop my running timer”
Team & Client Analysis
“Who on my team logged the most hours last month?”
“Show me all time entries for client Acme Corp”
“Get the contact information for everyone at Initech”
“What projects is Sarah working on?”
“List all active clients”
Profitability & Utilization
“What’s our profitability on the Acme project this quarter?”
“Compare profitability across all clients for 2024”
“What’s our team utilization rate this month?”
“Show me billable vs non-billable breakdown by team member”
“Which projects are most profitable?”
Budget Performance
“Which employees went over their project budgets this quarter?”
“Show me top performers who came in under budget”
“Who are the repeat offenders going over budget on multiple projects?”
“Compare budget variance by team member for 2024”
Invoicing & Expenses
“Show me all unpaid invoices”
“What invoices are open for Acme Corp?”
“List all expenses for the Johnson project”
“What’s been billed vs unbilled this quarter?”
Aggregation & Reporting
“Sum up hours by project for November”
“Break down time by client and user for Q4”
“Weekly hours summary for December”
“Show me time trends by month for 2024”
Available Tools (21)
Time Tracking
| Tool | Description |
|---|---|
harvest_list_time_entries |
List and filter time entries by user, client, project, date range |
harvest_get_time_entry |
Get a specific time entry by ID |
harvest_create_time_entry |
Create new time entries with optional timer |
harvest_stop_timer |
Stop a running timer |
harvest_delete_time_entry |
Delete a time entry |
Company & Team
| Tool | Description |
|---|---|
harvest_get_company |
Get company/account information |
安装
npx -y mcp-remote https://harvest-mcp.southleft.com/mcp配置
{
"mcpServers": {
"harvest": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://harvest-mcp.southleft.com/mcp"]
}
}
}