# Harvest MCP MCP Server

> **Harvest MCP MCP Server** is a hosted, multitenant Model Context Protocol (MCP) server run by **MewCP** (https://mewcp.com), giving AI agents managed access to Harvest MCP.
>
> MewCP takes care of all MCP infrastructure for you — credential storage, OAuth flows,
> token refresh, and production-grade auto-scaling — so your AI agents can connect to
> third-party services and run freely without you managing any MCP server yourself.
>
> Server page:  https://mewcp.com/mcp/harvestapp-mcp
> MewCP docs:   https://docs.mewcp.com
> All servers:  https://mewcp.com/servers (JSON: https://mewcp.com/api/servers)
> About MewCP:  https://mewcp.com/llms.txt

---

## About

Track billable hours and manage project finances directly through AI assistants with Harvest MCP. Start and stop timers, log and edit time entries, review project budgets and team utilization, manage clients and projects, record expenses, and create draft invoices from tracked time.

---

## Details

- Server ID: `harvestapp-mcp`
- Version: 1.0.0
- Tools: 39
- Authentication: OAuth, managed by MewCP
- Transport: http

---

## Access

The gateway URL below serves your **entire MewCP toolset**, not this server on its
own. Pasting a config snippet is not enough — Harvest MCP has to be in the toolset
first. In order:

1. Add Harvest MCP to your toolset at https://mewcp.com/mcp/harvestapp-mcp
2. Connect your Harvest MCP account (OAuth); MewCP stores the credential and attaches it to each call
3. Add the gateway URL to your client (see Connect below). It signs in with OAuth
   the first time it connects, so there is no key to copy.

Once connected, an agent does **not** see this server's tools as top-level tools.
It sees four meta-tools and reaches everything through them:

- `search(query)` — find tools by keyword across the toolset
- `get_schema(tools)` — full description and arguments for the tools you picked
- `manage_connections(requests?)` — connection status and account aliases, plus
  links the user opens to add an app or connect an account
- `call_tool(app_maskedId, tool_name, args, alias?)` — execute

If Harvest MCP isn't in the toolset or connected yet, `manage_connections` with
app_maskedId `harvestapp-mcp` returns a link that adds it and connects an account.

So the list below is what `search` can return for this server, not a set of
callable tool names on their own.

---

## Tools (39)

Descriptions are truncated to 160 characters; call `get_schema`
for the full text and the argument schema. Where a tool is annotated, its type
is shown — treat `destructive` as irreversible.

- `list_clients` _(read)_ — List clients in the user's Harvest account, ordered by name. Returns up to 100 clients per page; `total_count` is how many clients match the filter in full, so…
- `list_projects` _(read)_ — List projects in the user's Harvest account, ordered by project name unless `sort` is passed; each project includes its `starts_on` and `ends_on` dates…
- `list_tasks` _(read)_ — List tasks in the user's Harvest account, ordered by name. Returns up to 100 tasks per page; `total_count` is how many tasks match the filter in full, so when…
- `list_users` _(read)_ — List team members in the user's Harvest account, ordered by id. Returns up to 100 users per page; `total_count` is how many users match the filter in full on…
- `list_time_entries` _(read)_ — List time entries, most recent first. Defaults to the last 30 days when `from`/`to` are omitted. Each entry includes `started_time`/`ended_time` (24h "HH:MM"…
- `list_invoices` _(read)_ — List invoices, most recent first. Filter by `status` (draft/approved/open/sent/paid/late), `client_id`, issue-date range (`issued_from`/`issued_to`), an exact…
- `get_invoice` _(read)_ — Return a single invoice with its header (client, state, amounts, taxes, dates) and full `line_items`. Use `list_invoices` first to find the id. An invoice the…
- `create_invoice` _(write)_ — Create a free-form draft invoice for a client. `client_id` is required; supply `line_items` for the invoice content. The invoice number is assigned…
- `create_invoice_from_tracked_time` _(write)_ — Create a draft invoice for a client by importing uninvoiced billable tracked time and/or expenses for the given projects. `client_id` and `project_ids` are…
- `get_time_report` _(read)_ — Aggregate time entries over a date range, grouped by project, client, or user. Each row carries total, billable, and non-billable hours, plus invoiced and…
- `get_project_budget` _(read)_ — Return budget configuration and current usage for a specific project. `scope` states whether `hours_spent`/`money_spent` cover the `current_month`…
- `update_project_budget` _(write)_ — Set, change, or remove a project's budget. `budget_by` "project" is a Total project hours budget, "project_cost" a Total project fees (money) budget, and…
- `list_project_assignments` _(read)_ — List who and what is assigned to a project, with billable rates — the data needed to compute revenue/margin (pair it with get_project_budget for cost).…
- `get_running_timer` _(read)_ — Return the time entry whose timer is currently running for the authenticated user, or — for managers/admins — another team member via `user_id`. Returns null…
- `get_account_settings` _(read)_ — Return the authenticated account's capabilities and tracking conventions so a caller can pre-validate before attempting an action instead of probing blind.…
- `search_help_center` _(read)_ — Search the Harvest Help Center for product documentation: how a feature works, setup steps, integrations, billing, permissions, and troubleshooting. Returns…
- `start_timer` _(write)_ — Start a new running timer on the given project + task, for the authenticated user or — for managers/admins — another team member via `user_id`. If that user…
- `stop_timer` _(write)_ — Stop the currently running timer for the authenticated user. If `time_entry_id` is provided, stops that specific entry; otherwise stops whichever timer is…
- `log_time` _(write)_ — Log a completed time entry for the authenticated user, or — for managers/admins — another team member via `user_id`. Use this for past time you already know…
- `update_time_entry` _(destructive)_ — Update an existing time entry's hours, notes, project, task, date, or clock-in/clock-out times — your own, or a teammate's whose time you can edit in Harvest…
- `delete_time_entry` _(destructive)_ — Permanently delete a time entry — your own, or a teammate's whose time you can edit in Harvest (an admin, or a manager of them or of an active project they're…
- `create_project` _(write)_ — Create a project for an existing client. `name` and `client_id` are required. Set `hourly_rate` only when the project bills hourly; it is ignored without…
- `update_project` _(destructive)_ — Update a project's name, code, billing setup, active state, or billing currency — the fields are: name, project code, type (`hourly`, `fixed_fee`, or…
- `create_client` _(write)_ — Create a client in the user's Harvest account. `name` is required. `currency_code` defaults to the company currency when omitted.
- `update_client` _(destructive)_ — Update a client's name, address, currency, or active state. Only the supplied fields change; omit a field to leave it unchanged. Set `is_active` to false to…
- `submit_feedback` _(write)_ — Send feedback to the Harvest team. Call this only after the user agrees to send it; summarize their words and do not include data they did not choose to share.…
- `create_expense` _(write)_ — Create an expense for the authenticated user (or, for managers/admins, another user via `user_id`). Provide `total_cost` for amount-based categories, or…
- `update_expense` _(destructive)_ — Update an existing expense's amount, units, notes, billable flag, project, category, or date. Pass `delete_receipt: true` to remove an attached receipt.…
- `list_expenses` _(read)_ — List expenses, most recent first. Filter by `project_id`, `user_id`, a `spent_at` date range (`from`/`to`), `billable`, or `reimbursable`. `billable` and…
- `get_expense` _(read)_ — Return a single expense with full detail: amounts, units, category (name, unit metadata), project and client names, currency,…
- `list_expense_categories` _(read)_ — List the expense categories in the user's Harvest account, ordered by name. Use this to find the `expense_category_id` for `create_expense`. Unit-based…
- `submit_timesheet` _(write)_ — Submit the authenticated user's timesheet for approval over a date range (or, for managers/admins, another user's via `user_id`). Stop any running timer in the…
- `create_task` _(write)_ — Create a new task in the Harvest account. Tasks are the kinds of work that get assigned to projects (e.g. "Design", "Development"). Set `add_to_all_projects`…
- `update_task` _(destructive)_ — Update a task: rename it, change its default billable rate, and/or archive/reactivate it via `is_active`. Only the supplied fields change. A new name must be…
- `add_task_to_project` _(write)_ — Add a task to a project so time can be logged against it. Reactivates the task on the project if it was previously removed. Both the project and the task must…
- `assign_user_to_project` _(write)_ — Assign a user to a project so they can log time against it. Reactivates the assignment if it was previously removed. Requires permission to edit the project…
- `update_project_assignment` _(write)_ — Set the billable rate a person is billed at on one project, or switch them back to their own default rate. Pass `hourly_rate` for a rate that applies to this…
- `unassign_user_from_project` _(destructive)_ — Remove a user's assignment from a project. Historical time entries are preserved. Returns `removed: false` if the user was not assigned. Requires permission to…
- `remove_task_from_project` _(destructive)_ — Remove a task from a project. Historical time entries are preserved. Returns `removed: false` if the task was not assigned to the project. Requires permission…

---

## Connect

- URL: https://gateway.mewcp.com/personal/mcp
- Transport: Streamable HTTP (remote). Nothing to install.
- Sign-in: OAuth. On first connect the client opens a browser window to sign in
  to MewCP and approve access. No API key.
- Headless clients (SDKs, servers without a browser) send an API key instead:
  `Authorization: Bearer <API_KEY>`, key from https://mewcp.com/dashboard/api-keys

Agents setting themselves up: follow https://mewcp.com/SKILL.md

Step-by-step guide per client:

- Claude Desktop: https://mewcp.com/mcp/harvestapp-mcp/connect/claude
- ChatGPT: https://mewcp.com/mcp/harvestapp-mcp/connect/chatgpt
- Grok: https://mewcp.com/mcp/harvestapp-mcp/connect/grok
- DeepSeek Harness: https://mewcp.com/mcp/harvestapp-mcp/connect/dsh
- Mistral Vibe: https://mewcp.com/mcp/harvestapp-mcp/connect/mistral-vibe
- VS Code: https://mewcp.com/mcp/harvestapp-mcp/connect/vscode
- Cursor: https://mewcp.com/mcp/harvestapp-mcp/connect/cursor
- Codex: https://mewcp.com/mcp/harvestapp-mcp/connect/codex
- Claude Code: https://mewcp.com/mcp/harvestapp-mcp/connect/claude-code
- OpenCode: https://mewcp.com/mcp/harvestapp-mcp/connect/opencode
- OpenClaw: https://mewcp.com/mcp/harvestapp-mcp/connect/openclaw
- Antigravity: https://mewcp.com/mcp/harvestapp-mcp/connect/antigravity
- Hermes: https://mewcp.com/mcp/harvestapp-mcp/connect/hermes
- Kimi Code: https://mewcp.com/mcp/harvestapp-mcp/connect/kimi-code
- Grok Build: https://mewcp.com/mcp/harvestapp-mcp/connect/grok-build
- Devin Desktop: https://mewcp.com/mcp/harvestapp-mcp/connect/devin-desktop
- Zed: https://mewcp.com/mcp/harvestapp-mcp/connect/zed
- Muse Code: https://mewcp.com/mcp/harvestapp-mcp/connect/muse-code
- Cline: https://mewcp.com/mcp/harvestapp-mcp/connect/cline
- Kilo Code: https://mewcp.com/mcp/harvestapp-mcp/connect/kilo-code
- Kiro: https://mewcp.com/mcp/harvestapp-mcp/connect/kiro
- Junie: https://mewcp.com/mcp/harvestapp-mcp/connect/junie
- Amp: https://mewcp.com/mcp/harvestapp-mcp/connect/amp
- Qwen Code: https://mewcp.com/mcp/harvestapp-mcp/connect/qwen-code
- Goose: https://mewcp.com/mcp/harvestapp-mcp/connect/goose
- Python: https://mewcp.com/mcp/harvestapp-mcp/connect/python
- TypeScript: https://mewcp.com/mcp/harvestapp-mcp/connect/typescript