Skip to content

Harvest MCP by usefulapi

by usefulapi.io · remote · no sign-in to list tools · v1.16.4 · published by io.usefulapi

Read time entries, projects, clients, tasks and invoices; log and update tracked time.

Deletes · 5

20 tools: 5 can delete or cancel things and 15 only read.

Scanned Oct 22, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http harvest https://harvest.usefulapi.io/mcp

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

20 tools

Deletes or cancels 5Claude Code: deny
  • harvest_create_time_entryCreate a time entry.No findings

    Why it is in this group

    • The name "harvest_create_time_entry" says "create": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Create a time entry. Requires project_id, task_id and spent_date. Provide `hours` to log a specific duration; OR provide `started_time` (+ optional `ended_time`) for a timestamped entry; OR omit both to start a running timer (on a timestamp-tracking account). Use harvest_list_project_assignments to find valid project_id + task_id. Harvest REST: POST /time_entries. WRITE — creates data.

    Annotations the server declares

    • title: Create time entry
    • destructiveHint: true
  • harvest_delete_time_entryPermanently delete a time entry by id.No findings

    Why it is in this group

    • The name "harvest_delete_time_entry" says "delete": a word for removing or ending something.
    • The description says "Permanently delete".
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Permanently delete a time entry by id. This cannot be undone. Harvest REST: DELETE /time_entries/{id}. WRITE — destroys data.

    Annotations the server declares

    • title: Delete time entry
    • destructiveHint: true
  • harvest_restart_time_entryRestart a previously stopped time entry, resuming its timer (error if it is already running).No findings

    Why it is in this group

    • The name "harvest_restart_time_entry" says "restart": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Restart a previously stopped time entry, resuming its timer (error if it is already running). Harvest REST: PATCH /time_entries/{id}/restart. WRITE — modifies data.

    Annotations the server declares

    • title: Restart stopped time entry
    • destructiveHint: true
  • harvest_stop_time_entryStop a currently running time entry (no-op error if it is already stopped).No findings

    Why it is in this group

    • The name "harvest_stop_time_entry" says "stop": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Stop a currently running time entry (no-op error if it is already stopped). Harvest REST: PATCH /time_entries/{id}/stop. WRITE — modifies data.

    Annotations the server declares

    • title: Stop running time entry
    • destructiveHint: true
  • harvest_update_time_entryUpdate an existing time entry's hours, notes, spent date, or project/task.No findings

    Why it is in this group

    • The name "harvest_update_time_entry" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Update an existing time entry's hours, notes, spent date, or project/task. Only the fields you provide are changed. Harvest REST: PATCH /time_entries/{id}. WRITE — modifies data.

    Annotations the server declares

    • title: Update time entry
    • destructiveHint: true
Only reads 15Claude Code: allow
  • harvest_get_clientRetrieve a single client by id.No findings

    Why it is in this group

    • The name "harvest_get_client" says "get": a word for reading.
    Description, as the server wrote it
    Retrieve a single client by id. Harvest REST: GET /clients/{id}.

    Annotations the server declares

    • title: Get client
    • readOnlyHint: true
  • harvest_get_companyRetrieve the company/account settings for the authenticated account (name, currency, time/date formats, week start, feature flags).No findings

    Why it is in this group

    • The name "harvest_get_company" says "get": a word for reading.
    Description, as the server wrote it
    Retrieve the company/account settings for the authenticated account (name, currency, time/date formats, week start, feature flags). Harvest REST: GET /company.

    Annotations the server declares

    • title: Get company
    • readOnlyHint: true
  • harvest_get_current_userRetrieve the currently authenticated user (whom the access token belongs to).No findings

    Why it is in this group

    • The name "harvest_get_current_user" says "get": a word for reading.
    Description, as the server wrote it
    Retrieve the currently authenticated user (whom the access token belongs to). Harvest REST: GET /users/me.

    Annotations the server declares

    • title: Get current user
    • readOnlyHint: true
  • harvest_get_invoiceRetrieve a single invoice by id, including its line items.No findings

    Why it is in this group

    • The name "harvest_get_invoice" says "get": a word for reading.
    Description, as the server wrote it
    Retrieve a single invoice by id, including its line items. Harvest REST: GET /invoices/{id}.

    Annotations the server declares

    • title: Get invoice
    • readOnlyHint: true
  • harvest_get_projectRetrieve a single project by id.No findings

    Why it is in this group

    • The name "harvest_get_project" says "get": a word for reading.
    Description, as the server wrote it
    Retrieve a single project by id. Harvest REST: GET /projects/{id}.

    Annotations the server declares

    • title: Get project
    • readOnlyHint: true
  • harvest_get_time_entryRetrieve a single time entry by id.No findings

    Why it is in this group

    • The name "harvest_get_time_entry" says "get": a word for reading.
    Description, as the server wrote it
    Retrieve a single time entry by id. Harvest REST: GET /time_entries/{id}.

    Annotations the server declares

    • title: Get time entry
    • readOnlyHint: true
  • harvest_list_clientsList clients, optionally filtered by active status or updated-since.No findings

    Why it is in this group

    • The name "harvest_list_clients" says "list": a word for reading.
    Description, as the server wrote it
    List clients, optionally filtered by active status or updated-since. Paginated. Harvest REST: GET /clients.

    Annotations the server declares

    • title: List clients
    • readOnlyHint: true
  • harvest_list_estimatesList estimates, optionally filtered by client, state, date range, or updated-since.No findings

    Why it is in this group

    • The name "harvest_list_estimates" says "list": a word for reading.
    Description, as the server wrote it
    List estimates, optionally filtered by client, state, date range, or updated-since. Paginated. Harvest REST: GET /estimates.

    Annotations the server declares

    • title: List estimates
    • readOnlyHint: true
  • harvest_list_expensesList expenses, optionally filtered by user, client, project, date range, billed status, or updated-since.No findings

    Why it is in this group

    • The name "harvest_list_expenses" says "list": a word for reading.
    Description, as the server wrote it
    List expenses, optionally filtered by user, client, project, date range, billed status, or updated-since. Paginated. Harvest REST: GET /expenses.

    Annotations the server declares

    • title: List expenses
    • readOnlyHint: true
  • harvest_list_invoicesList invoices, optionally filtered by client, project, state, date range, or updated-since.No findings

    Why it is in this group

    • The name "harvest_list_invoices" says "list": a word for reading.
    Description, as the server wrote it
    List invoices, optionally filtered by client, project, state, date range, or updated-since. Paginated. Harvest REST: GET /invoices.

    Annotations the server declares

    • title: List invoices
    • readOnlyHint: true
  • harvest_list_project_assignmentsList the authenticated user's active project assignments — the projects and their assignable tasks the current user can log time against (use this to find the project_id + task_id …No findings

    Why it is in this group

    • The name "harvest_list_project_assignments" says "list": a word for reading.
    Description, as the server wrote it
    List the authenticated user's active project assignments — the projects and their assignable tasks the current user can log time against (use this to find the project_id + task_id for harvest_create_time_entry). Paginated. Harvest REST: GET /users/me/project_assignments.

    Annotations the server declares

    • title: List my project assignments
    • readOnlyHint: true
  • harvest_list_projectsList projects, optionally filtered by active status or client, or updated-since.No findings

    Why it is in this group

    • The name "harvest_list_projects" says "list": a word for reading.
    Description, as the server wrote it
    List projects, optionally filtered by active status or client, or updated-since. Paginated. Harvest REST: GET /projects.

    Annotations the server declares

    • title: List projects
    • readOnlyHint: true
  • harvest_list_tasksList tasks (the billable/non-billable work categories that can be assigned to projects), optionally filtered by active status or updated-since.No findings

    Why it is in this group

    • The name "harvest_list_tasks" says "list": a word for reading.
    Description, as the server wrote it
    List tasks (the billable/non-billable work categories that can be assigned to projects), optionally filtered by active status or updated-since. Paginated. Harvest REST: GET /tasks.

    Annotations the server declares

    • title: List tasks
    • readOnlyHint: true
  • harvest_list_time_entriesList time entries, optionally filtered by user, project, client, task, date range, running/billed status, or updated-since.No findings

    Why it is in this group

    • The name "harvest_list_time_entries" says "list": a word for reading.
    Description, as the server wrote it
    List time entries, optionally filtered by user, project, client, task, date range, running/billed status, or updated-since. Paginated. Harvest REST: GET /time_entries.

    Annotations the server declares

    • title: List time entries
    • readOnlyHint: true
  • harvest_list_usersList users in the account, optionally filtered by active status or updated-since.No findings

    Why it is in this group

    • The name "harvest_list_users" says "list": a word for reading.
    Description, as the server wrote it
    List users in the account, optionally filtered by active status or updated-since. Paginated. Harvest REST: GET /users.

    Annotations the server declares

    • title: List users
    • readOnlyHint: true

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Exfil surface

Which tools read private data, which read text someone else can write, and which can send data out. One of each is a path a prompt injection can use.

No private-data, untrusted-input, outbound path in this server alone: no tool is tagged private-data or untrusted-input or outbound.

Reads private data0
Reads files, mail, messages, databases, secrets, calendars or repositories.
Reads text others write0
Brings in text someone else can write: web pages, inbound email, messages, issues and comments.
Can send data out0
Can carry data to people or systems: it sends, posts or publishes, or takes a recipient, channel or URL.

Other servers in the same agent add their own tools to these paths. Audit your whole setup to see them together.

Remote posture

What anyone on the internet sees at the remote endpoint: an anonymous initialize and tools/list, and the public OAuth metadata.

Looked at Oct 22, 2026, 15:29 UTC, unchanged since Oct 22, 2026. No credentials were sent and no tool was called. What is looked at.

Reachable
yes
HTTP status of an anonymous initialize
200
tools/list served without credentials
yes
Tools that change things, listed without credentials
5
Protocol version
2025-06-18
WWW-Authenticate on 401
not observed
resource_metadata in WWW-Authenticate
none
RFC 9728 protected resource metadata
https://harvest.usefulapi.io/.well-known/oauth-protected-resource/mcp
Authorization servers
https://harvest.usefulapi.io
Legacy HTTP+SSE transport
no
Dynamic client registration
yes
Client ID metadata documents
no
  • HighThe whole server

    The endpoint served tools/list without credentials, and the list has 5 tools that change things (5 destructive). Whether a call also works without credentials was not tested: tools are never called.

    Matched text

    https://harvest.usefulapi.io/mcp: tools/list returned 20 tools to an anonymous client, including harvest_create_time_entry (destructive), harvest_update_time_entry (destructive), harvest_stop_time_entry (destructive), harvest_restart_time_entry (destructive), harvest_delete_time_entry (destructive)

    What this check looks for

Install

Pinned to version 1.16.4. Values in angle brackets are yours to fill in.

claude mcp add --transport http harvest https://harvest.usefulapi.io/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change or a way out, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__harvest__harvest_list_time_entries",
      "mcp__harvest__harvest_get_time_entry",
      "mcp__harvest__harvest_list_projects",
      "mcp__harvest__harvest_get_project",
      "mcp__harvest__harvest_list_clients",
      "mcp__harvest__harvest_get_client",
      "mcp__harvest__harvest_list_tasks",
      "mcp__harvest__harvest_list_users",
      "mcp__harvest__harvest_get_current_user",
      "mcp__harvest__harvest_list_project_assignments",
      "mcp__harvest__harvest_list_invoices",
      "mcp__harvest__harvest_get_invoice",
      "mcp__harvest__harvest_list_estimates",
      "mcp__harvest__harvest_list_expenses",
      "mcp__harvest__harvest_get_company"
    ],
    "ask": [],
    "deny": [
      "mcp__harvest__harvest_create_time_entry",
      "mcp__harvest__harvest_update_time_entry",
      "mcp__harvest__harvest_stop_time_entry",
      "mcp__harvest__harvest_restart_time_entry",
      "mcp__harvest__harvest_delete_time_entry"
    ]
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. A read that can send data out (it takes a URL, say) asks first too. It assumes the server is installed as harvest. Review it before you use it.