# Harvest MCP for AI Agents AI Agent Connect > Harvest MCP lets you manage your time tracking, client data, and invoicing through your AI agent. You can create clients, generate invoice drafts, and monitor project time entries without leaving your chat interface. It turns your agent into a dedicated billing coordinator. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_9ZceUzjpsGe2vuLka4VTRAovXZLfDxLUaCcxKJpn/ai-agent-connect - **Tags:** time-tracking, invoicing, project-billing, expense-tracking, timesheets, client-management ## Description This Connector connects your Harvest account to your AI agent so you can manage time tracking, client data, and invoicing through natural conversation. Imagine you're in the middle of a project wrap-up and need to see how many hours your team actually spent on a specific milestone. Usually, that means digging through a dashboard, filtering by date, and exporting a CSV just to get a clear picture. With this connection, you just ask your agent. You can have it pull a summary of time entries for a specific project or check the status of a pending invoice for a client in seconds. It handles the tedious heavy lifting of client management too. If you need to add a new client or update a company's details, you don't have to switch tabs. Your agent just does it. It’s about moving from manual data entry to just having the right information when you need it. Because Vinkius makes it easy to connect these tools, you can treat your AI client like a member of your operations team that never misses a billing deadline or a time entry update. This is a huge shift for small agencies and freelancers who find themselves bogged down by the administrative side of their business. Instead of spending hours on the books, you can spend that time on the work that actually pays the bills. It turns your chat interface into a command center for your entire billing cycle. ## Tools ### list_projects Get a full list of every project in your account. This helps you see what's currently active across your organization. ### list_time_entries Pull all tracked time entries from your team. Use this to monitor productivity and see where time is being spent. ### update_client Change the name of an existing client. This keeps your records accurate without manual edits in the app. ### delete_client Remove a client from your Harvest account permanently. This helps keep your database clean of old accounts. ### create_client Add a new client to your Harvest records. It saves you from having to navigate to the client management page. ### create_invoice Generate a new invoice for a specific client. You can do this quickly without opening the billing section. ### get_client Fetch detailed information for a specific client. Use this to quickly check a client's current status or details. ### get_invoice Pull the details of a specific invoice. It's the fastest way to see if a bill has been paid or sent. ### get_my_profile Retrieve information about the currently authenticated user. This helps your agent know who is making the requests. ### list_clients See every client in your Harvest account at once. Use this to get a high-level view of your entire client base. ### list_invoices View all invoices including drafts and sent items. It makes it easy to spot which bills are still outstanding. ## Prompt Examples **Prompt:** ``` Show me the total time logged for the 'Mobile App' project this month. ``` **Response:** ``` I've pulled the time entries for the 'Mobile App' project. Here is the summary for this month: | Project Milestone | Total Hours | | :--- | :--- | | UI Design | 42h | | Backend Dev | 88h | | QA Testing | 15h | **Total: 145 hours** Would you like me to list the specific entries for the Backend Dev phase? ``` **Prompt:** ``` Add a new client called 'Starlight Media' to my account. ``` **Response:** ``` Done! I've added 'Starlight Media' as a new client in your Harvest account. Would you like me to create a new project for them now? ``` **Prompt:** ``` What's the status of our invoices for Acme Corp? ``` **Response:** ``` I've checked your invoices for Acme Corp. Here's what I found: * **Invoice #1024**: Paid (Oct 12) * **Invoice #1056**: Sent (Nov 01) * **Invoice #1088**: Draft (Pending review) Would you like me to send the draft for #1088 or create a new one? ``` ## Capabilities ### Create new clients Add a new client to your Harvest account with a single request. ### Generate invoice drafts Create new invoices for specific clients directly through your agent. ### Monitor project time View all active projects and their associated time logs. ### Track time entries List every logged time entry to see exactly where hours are going. ### Update client details Change client names or company info without opening the Harvest app. ### Check invoice status View your entire history of sent and draft invoices. ## Use Cases ### Summarizing hours for a status call Instead of exporting a sheet, a project manager asks their agent to list time entries for the 'Website Redesign' project and get a summary immediately. ### Billing a client after a milestone A freelancer tells their agent to create a new invoice for 'Acme Corp' using `create_invoice`, skipping the manual entry steps. ### Monitoring active project volume An operations lead uses `list_projects` to see all ongoing work and then checks `list_time_entries` to see which projects are getting the most attention. ### Onboarding a new partner A small agency asks their agent to use `create_client` to add 'Global Tech' to their Harvest account instantly. ## Benefits - Stop manual data entry by using `create_client` and `update_client` to keep your records current without leaving your chat. - Get instant visibility into team output by using `list_time_entries` to see exactly how hours are distributed. - Speed up your billing cycle by using `create_invoice` to generate drafts on the fly during project wrap-ups. - Keep track of every project status by using `list_projects` to see what's active across your entire organization. - Reduce the risk of missed payments by using `list_invoices` to quickly identify which bills are still in draft or sent status. ## How It Works The bottom line is you get a hands-off way to manage your billing and time tracking through natural conversation. 1. Subscribe to the Harvest MCP on Vinkius. 2. Provide your Harvest Access Token and Account ID in your AI client. 3. Ask your agent to list projects or create an invoice. ## Frequently Asked Questions **Can I use the Harvest MCP to see how many hours my team worked?** Yes. You can ask your agent to list time entries for specific projects or dates to get a clear view of your team's output. **Does the Harvest MCP let me create new invoices?** It does. You can have your agent create invoice drafts for your clients directly, which saves you from manual data entry in the Harvest app. **Can I use Harvest to manage my client list?** Yes, you can use the Connector to add new clients, update existing client names, or delete old accounts through your AI client. **Is the Harvest MCP good for freelancers?** It's great for freelancers who need to track time and manage billing without switching between different apps all day. **Can I check if a client has paid their bill using Harvest?** You can use the Connector to list all invoices and check their status, making it easy to see what's paid, sent, or still in draft. **How does the Harvest MCP help with project monitoring?** It allows your agent to list all active projects and pull detailed info, so you can stay on top of your workload during status calls. **How do I find my Harvest Access Token and Account ID?** Go to the **Harvest Developers** site (id.getharvest.com), navigate to **Personal Access Tokens**, and create a new token. You will find both the **token** and the **Account ID** listed there. **Can I see time entries for a specific period?** Yes! Use the `list_time_entries` tool and provide the `from` and `to` dates in YYYY-MM-DD format to retrieve records for that timeframe. **Is it possible to create invoices through this integration?** Yes, you can use the `create_invoice` tool by providing a `client_id` and an optional `subject` to generate a new invoice draft in your Harvest account. **Is the integration secure for managing financial data?** Absolutely. The integration uses official Harvest API tokens over HTTPS. Your credentials are encrypted and stored securely within the Vinkius Cloud infrastructure.