Harvest MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Harvest MCP or direct API to log hours, generate invoices, track project budgets, and pull time reports through natural language.

Harvest logoHarvest
Oauth2

Harvest is a time-tracking and invoicing platform for teams and freelancers. It helps you log billable hours, manage projects, and streamline payments.

57 Tools

Try Harvest now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Harvest
Try asking
TOOLS

Supported Tools

Every Harvest action and event your agent gets out of the box.

Create Client

Tool to create a new client.

Create Client Contact

Tool to create a new client contact.

Create Estimate

Tool to create a new estimate.

Create Estimate Item Category

Tool to create a new estimate item category in Harvest.

Create Estimate Message

Tool to create a new message for an estimate.

Create Expense

Tool to create a new expense entry.

Create Invoice

Tool to create a new invoice.

Create Invoice Item Category

Tool to create a new invoice item category.

Create Invoice Message

Creates a new message for an invoice in Harvest.

Create Invoice Payment

Tool to create a new payment on an invoice.

Create Project

Create a new project in Harvest.

Create Task

Creates a new task in Harvest.

Create Time Entry

Tool to create a new time entry.

Create User

Creates a new user in Harvest and sends an invitation email to the specified address.

Delete Client

Tool to delete a client.

Delete Client Contact

Permanently deletes a client contact from Harvest.

Delete Estimate

Tool to delete an estimate.

Delete Estimate Message

Tool to delete an estimate message.

Delete Invoice

Delete an invoice from Harvest.

Delete Invoice Item Category

Tool to delete an invoice item category from Harvest.

Delete Invoice Message

Tool to delete a message from an invoice.

Delete Invoice Payment

Tool to delete an invoice payment.

Delete Project

Tool to delete a project.

Delete Task

Tool to delete a task.

Delete Time Entry

Tool to delete a time entry.

Delete User

Tool to delete a user.

Get Client

Retrieves a specific client by ID from Harvest.

Get Company Info

Retrieves detailed information about the company associated with the authenticated Harvest account.

Get Estimate

Tool to retrieve a specific estimate by ID.

Get Invoice

Tool to retrieve a specific invoice by ID.

Get Project

Tool to retrieve a specific Harvest project by ID.

Get Task

Tool to retrieve a specific task by ID.

Get Time Entry

Tool to retrieve a single time entry by ID.

Get User

Tool to retrieve a specific user by ID.

List Client Contacts

Tool to list client contacts.

List Clients

Tool to list clients.

List Estimate Messages

Lists all messages associated with a specific estimate in Harvest.

List Expense Categories

Tool to list expense categories.

List Invoice Item Categories

Tool to retrieve invoice item categories.

List Invoice Messages

Tool to list messages associated with a given invoice.

List Invoice Payments

List all payments recorded for a specific invoice.

List Invoices

Tool to list invoices.

List projects

Tool to list projects.

List Tasks

Tool to list tasks.

List Time Entries

Tool to retrieve a list of time entries.

List Users

Tool to list users.

Update Client

Tool to update an existing client.

Update Client Contact

Tool to update a client contact.

Update Company Info

Updates company time tracking settings in Harvest.

Update Estimate

Tool to update an existing estimate.

Update Estimate Item Category

Updates an existing estimate item category's name in Harvest.

Update Expense

Tool to update an existing expense.

Update Invoice

Tool to update an existing invoice.

Update Project

Tool to update an existing project.

Update Task

Tool to update an existing task.

Update Time Entry

Tool to update an existing time entry.

Update User

Tool to update an existing user.

SETUP GUIDE

Connect Harvest MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK and Claude Agent SDK
2

Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });

console.log("Creating Tool Router session...");
const { mcp } = await composio.create('your-user-id');
console.log(`Tool Router session created: ${mcp.url}`);
Initialize the Composio client and create a Tool Router session
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText, stepCountIs } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: mcp.url,
    headers: { 'x-api-key': 'your-composio-api-key' }
  }
});

const tools = await client.tools();

const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{ role: 'user', content: 'Create a new invoice for client Acme Corp' }],
  stopWhen: stepCountIs( 5 )
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent
SETUP GUIDE

Connect Harvest API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Harvest Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Create a new invoice for client Acme Corp with today\'s billable hours.'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Harvest actions with your Agent

Why Use Composio?

AI Native Harvest Integration

  • Supports both Harvest MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Harvest data

Managed Auth

  • Built-in OAuth handling with automatic token refresh and rotation
  • Central place to manage, scope, and revoke Harvest access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Harvest
  • Scoped, least privilege access to Harvest resources
  • Full audit trail of agent actions to support review and compliance
FAQ

Frequently asked questions

No, you can get started immediately using Composio's built-in Harvest app. For production, we recommend configuring your own OAuth credentials.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with Harvest.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Harvest tool your agent needs.Free to start.

Start building