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.
20 tools: 5 can delete or cancel things and 15 only read.
Scanned Oct 22, 2026
- Deletes or cancels5Claude Code: deny: see these tools
- Can't be undone0Claude Code: ask
- Changes things0Claude Code: ask
- Only reads15Claude Code: allow: see these tools
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/mcpTools
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.
What this check looks forMatched 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)
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/mcpRun 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.
{
"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.