What can Kea and the Projectworks MCP do? (beta)
Everything you can ask Kea, or your own AI tool through the Projectworks MCP, to look up or change in Projectworks, with an example for each.
Please note this is a Beta Feature.
Overview
There are two ways to use AI with Projectworks:
- Kea is the AI assistant built into Projectworks. Open the Kea chat from any page and ask in your own words. Kea also reads receipts to fill in expense claims.
- The Projectworks MCP connects Projectworks to an AI tool you already use, such as Claude, ChatGPT or Microsoft Copilot.
See Connect Projectworks to Claude → or Connect Projectworks to ChatGPT, Copilot or another AI tool →
Both can do almost all the same things, listed below. Where something only works in one of them, the row says so.
Reads look something up and change nothing. Changes are shown to you first and only saved once you approve them.
Finding things and getting help
| What you can do | How it works | Try asking | Access |
|---|---|---|---|
| Find a record | Finds the person, client, contact, project, budget, timecode, invoice, quote, expense claim, purchase order or office you mean from part of a name, a number or a partial match. | “Open the Acme rebuild project” | Reads |
| Know who you are | Works out which account you’re signed in as, so “my” and “me” mean you. | “What’s on my timesheet this week?” | Reads |
| Point you to the right page | Gives you a direct link to the page you need, with the right record already open, including for things it can’t do itself. Kea only. | “Where do I set up a new client?” | Reads |
| Answer how-to questions | Searches this help centre to explain how something works or how to do it yourself, and links to the articles it used. Kea only. | “How do I unlock a submitted timesheet?” | Reads |
| Suggest what to ask next | Offers up to three likely follow-up questions after an answer. Kea only. | After a resourcing answer: “Who else is free that week?” | Reads |
| Ask you a quick question | When Kea needs a detail, or has to choose between several matches, it asks with up to three suggested answers. You can always type your own instead. Kea only. | “Which Acme project did you mean?” | Reads |
| Read a file you attach | Attach a JPG, PNG, PDF, CSV or XLSX and ask questions about it. Up to five files per message, 20 MB in total. Long spreadsheets are cut short, and workbooks over 10,000 cells can’t be read. Kea only. | “What roles and hours are in this work breakdown?” | Reads |
| Raise a support ticket | If you’re stuck, Kea offers to draft a support ticket from the conversation. You check and edit it, then send it yourself, and the conversation goes with it. Kea only. | “Can I talk to someone about this?” | Changes |
Clients and contacts
| What you can do | How it works | Try asking | Access |
|---|---|---|---|
| Look up a client | Finds a client by name and reports its office, account manager, currency, default sales tax, client type and external reference. Can include its custom fields, and inactive clients when you ask. | “Who is the account manager for Harbour Studios?” | Reads |
| Look up billing contacts | Finds a contact by name or email, or lists everyone at one client, with their email, CC addresses, phone, notes, address and custom fields. | “Who are the billing contacts at Acme?” | Reads |
| Add a new client | Creates a client with its name, office, account manager, currency and default sales tax, plus a client type, external reference and custom fields if you want them. The office’s usual currency and sales tax are suggested unless you say otherwise. | “Add Harbour Studios as a new client in the Wellington office, managed by Sam” | Changes |
| Change or archive a client | Changes a client’s name, office, account manager, sales tax, client type, external reference or custom fields, and shows each change before and after. The currency can’t change once the client has projects. Archives a client with no opportunity, committed or in-progress projects, or unarchives one. Clients can’t be deleted. | “Change the account manager for Harbour Studios to Priya” | Changes |
| Add a billing contact | Adds a contact to a client with a name and email, and optionally CC addresses, a phone number, notes and custom fields. Uses the client’s address unless you give a separate one. | “Add Jo Smith, [email protected], as a contact at Harbour Studios” | Changes |
| Change or deactivate a billing contact | Changes a contact’s email, CC addresses, phone, notes, address or custom fields, or switches them back to the client’s address. Deactivates or reactivates a contact, and warns you if they’re the default billing contact on active projects. Contacts can’t be deleted or moved to another client. | “Add [email protected] as a CC on Jo Smith’s invoices” | Changes |
People and offices
| What you can do | How it works | Try asking | Access |
|---|---|---|---|
| Look up people | Finds people by name or email, or lists everyone in an office or reporting to a manager, with their current team, position, rank and manager. People who have left are included only if you have permission to see them. | “Who reports to Priya?” | Reads |
| Look up offices | Lists your offices, with the currency and default sales tax each one uses. | “What currency does our Sydney office bill in?” | Reads |
Projects, budgets and timecodes
| What you can do | How it works | Try asking | Access |
|---|---|---|---|
| Find projects | Searches projects by name or number, and narrows them by client, office, type, status, or start and end dates. Archived and inactive projects are included when you ask. | “Which Acme projects finish before Christmas?” | Reads |
| See how a project is set up | Reports a project’s number, dates, client, office, type, status, currency and managers. For its permissions and tracking categories, use the MCP. | “Which office is working on the Acme project?” | Reads |
| See who is on a project | Lists the people already on a project. Through the MCP it can also tell you who else could be added. | “Who’s on the Acme project?” | Reads |
| Create a project | Creates a project for a client with its name, office, project manager, type and status, a rate card or standard rates, and any custom fields. Suggests Billable and In Progress unless you say otherwise. Currency and account manager come from the client, and the project number is given when it’s saved. | “Create a Brand Refresh project for Harbour Studios, managed by Alex” | Changes |
| Change, archive or unarchive a project | Changes a project’s name, number, dates, type, status, project manager, account manager, default purchase order, default billing contact, external reference or custom fields. Archiving isn’t possible while the project has resourcing from next week on, forecasts from this month on, or billable time that hasn’t been invoiced or written off; to archive with a write-off, use Projectworks. Unarchiving returns the project to In Progress. Its currency, rate card, client, office and the people on it can’t be changed this way. | “Move the end date of the Brand Refresh project to 31 March” | Changes |
| See budgets | Finds budgets by name, or lists the budgets on a project, with whether each is for time or expenses, how its fee is set, its amount, GL code and custom fields. Amounts are hidden if you can’t see dollar values. For burn and forecast, see Money, expenses and invoices. | “What budgets do I have on the Brand Refresh project?” | Reads |
| Add budgets to a project | Adds one or more time or expense budgets to an existing project, each with a name, a fee amount or a fee built up from its timecodes, a revenue GL code on billable projects, and any custom fields. If you leave the GL code out, your office’s default code is used. | “Add a $40,000 Discovery budget and a $5,000 travel expenses budget to the Brand Refresh project” | Changes |
| Change or deactivate a budget | Changes a budget’s name, how its fee is set, its amount, GL code, order, tracking categories or custom fields, or deactivates it. The GL code is locked once the budget has invoices or accruals. A budget’s type (time or expenses) can’t change, and budgets can’t be deleted. | “Increase the Discovery budget on Brand Refresh to $45,000” | Changes |
| See timecodes | Lists the timecodes on a project or budget with their settings: whether they’re billable, the default rate, the fee, dates and custom fields. Rates and fees are hidden if you can’t see dollar values. | “What timecodes are on the Discovery budget?” | Reads |
| See who is on a timecode | Lists everyone on a timecode with their allocated, logged and remaining hours and the value of the time they’ve worked, plus totals for the timecode. You can limit logged hours to a date range. Values are hidden if you can’t see dollar values. | “How many hours does each person have left on the Design timecode?” | Reads |
| Add or change timecodes | Adds timecodes to an existing time budget, or changes existing ones: name, billable, default rate, fee, dates, whether a comment is required, and custom fields. A timecode can be made inactive, or moved to another budget on the same project until its time is invoiced. | “Add a Design timecode to the Discovery budget on the Brand Refresh project” | Changes |
| Manage who is on a timecode | Adds people to a timecode, sets their allocated hours, and changes their billable rate or, for contractors, their cost rate. Takes someone off a timecode; the time they’ve already logged stays. Changing rates needs permission to see dollar values and to edit rates. | “Give Alex 40 allocated hours on the Design timecode” | Changes |
Money, expenses and invoices
| What you can do | How it works | Try asking | Access |
|---|---|---|---|
| Check financial performance | Shows burn, budget, cost, margin, invoiced and forecast figures for a project or an individual budget. Can total them by client, office, project manager or status. | “Which projects are over 90% burnt?” | Reads |
| Check work in progress | Shows your work in progress at any date you choose, including uninvoiced time and expenses and how long they’ve been sitting there. | “What’s our WIP by client at the end of last month?” | Reads |
| See expenses | Finds expense claims by person, project, client, status or date, with the amount, tax, expense type, budget, and whether each is reimbursable or billable. Totals are given per currency. Billable and margin amounts are hidden if you can’t see dollar values. | “What expenses are pending on the Acme project this month?” | Reads |
| Add an expense | Adds up to ten expenses at once, for you or someone you can claim for, each with a project, expense budget, expense type, date, amount, tax and up to four receipts. In Kea, attach the receipt and Kea fills in the details from it. Reimbursable claims start as pending. | “Add this receipt as a reimbursable expense on the Acme project” | Changes |
| See invoices | Finds invoices by project, client, status or date, with the amounts, due date, payments, what’s still owed, how many days overdue it is, whether it was emailed, and any accounts receivable notes. It can’t create, change or send invoices. | “Which invoices on the Acme project are unpaid, and when were they sent?” | Reads |
Forecasts
You need permission to see forecasts and dollar values.
| What you can do | How it works | Try asking | Access |
|---|---|---|---|
| See forecasts | Shows what you expect to invoice, month by month, by budget or by project, for up to 24 months at a time. Filter by client, office, status, project manager or account manager. Totals are given per currency. | “What are we forecasting to invoice next month, by project?” | Reads |
| See why a forecast changed | Shows the change history for a budget’s or project’s month: who changed it, when, the amount before and after, and any comment left with the change. | “Why did the Acme forecast for March change?” | Reads |
| Check forecast accuracy | Compares what was forecast with what was invoiced for each project and month, and flags the months outside your accuracy limits. Shows whether each one has a reason recorded, and whether that reason is out of date. | “Which accuracy exceptions from last month still need a reason?” | Reads |
| Change forecasts | Sets budget forecasts for one or more months, up to 100 changes at once, with an optional comment kept in the history. Only months inside your editable window can change, and archived, inactive or non-billable work can’t be forecast. | “Set the Discovery budget’s forecast for December to $12,000” | Changes |
| Publish a schedule to the forecast | Replaces a project’s services forecasts with amounts from its scheduled tasks, for up to ten projects at once. Other forecast months from your editable window onwards are set to zero, and the approval tells you how many first. This can’t be undone. | “Publish the Brand Refresh schedule to its invoice forecasts” | Changes |
| Explain an accuracy exception | Records the reason for a project month that’s outside your accuracy limits: one of your reason types, plus a comment in your own words. | “Record that the Acme invoice slipped into November as the reason for October” | Changes |
Resourcing
| What you can do | How it works | Try asking | Access |
|---|---|---|---|
| See who is booked on what | Shows people and unfilled roles booked on projects, with their hours, whether a booking is pencilled or confirmed, plus capacity, leave, and what they’re doing on other projects. | “Who’s booked on Acme in August, and for how many hours?” | Reads |
| Spot who is over- or under-booked | Adds up a person’s booked hours across every project, period by period, and compares that against the time they actually have. | “Is anyone over-booked next month?” | Reads |
| See a project’s total booked hours | Totals the hours booked on a project, period by period. | “How many hours are booked on Acme this quarter?” | Reads |
| Change bookings | Moves hours between projects, adds or swaps people and unfilled roles, shifts bookings out or in, pencils or confirms them, and leaves comments. People added to a project get their usual billable rate. | “Move Sam’s 8 hours a day from Acme Services to Harbour User Testing next week” | Changes |
Leave
| What you can do | How it works | Try asking | Access |
|---|---|---|---|
| See who is on leave | Shows leave by person, team, office, manager, leave type, status or dates, in hours per day, and whether it has been sent to payroll. Leave balances aren’t available. | “Who in the Auckland office is on leave next week?” | Reads |
| See leave waiting for you | Lists the pending leave requests you can approve, oldest first. | “What leave do I need to approve?” | Reads |
| Book or change leave | Requests leave using the leave types, working hours and public holidays set up for that person, including part days and mixed leave types. Editing a request sends it back for approval. Withdrawing a request deletes it. | “Book me annual leave from 20 to 24 October” | Changes |
| Approve or decline leave | Approves or declines pending leave, with a comment for the person if you want one, including several requests at once. | “Approve all the leave waiting for me” | Changes |
Time and timesheets
| What you can do | How it works | Try asking | Access |
|---|---|---|---|
| See what you can log time against | Lists the timecodes assigned to you for a week, by project and client, and flags any that need a comment. Through the MCP you can also search for timecodes you aren’t assigned to yet. | “What can I log time against this week?” | Reads |
| Read a timesheet week | Shows one person’s week: the hours on each line, the status of the week, anything locked, and any entries adjusted or written off. Lines with no time logged are left out. | “What’s on my timesheet, and is it submitted?” | Reads |
| See who hasn’t submitted | Shows timesheet status and hours logged per person per week across a date range, so you can chase the gaps. | “Who on my team hasn’t submitted last week?” | Reads |
| Log, clear or move time | Enters hours against the right timecode, clears them, or moves entries to another timecode, keeping each entry’s person, date, hours and comment. Assigns you to a timecode automatically where that’s allowed, at the rate the project would normally give you. | “Log 6 hours to Acme design on Tue and Wed” | Changes |
| Mark time reviewed | Marks time entries reviewed or not reviewed, picked individually or for chosen people or projects across a date range. Entries already in that state, exported, or that you can’t review are left out, and you’re told why. | “Mark all of last week’s time on the Acme project as reviewed” | Changes |
| Adjust billable hours | Sets adjusted hours, which is what a time entry bills, without changing the hours the person logged. Use a rule for every entry in a period, based on how many hours each entry has, optionally for chosen people, projects or budgets. Or adjust, write off or undo individual entries. Entries that are already adjusted are skipped unless you say to replace them. Invoiced, written-off and non-billable entries never change. | “On the Acme project in October, bill any entry over 8 hours as 8 hours” | Changes |
| Submit, approve or decline timesheets | Submits your own week, or approves, declines and withdraws timesheets for the people you manage, including in bulk. | “Approve my team’s timesheets for last week” | Changes |
Nothing changes without your say-so
When you ask for something to change, it’s drafted and checked first, then shown to you in full, so you can see exactly what would happen before anything is saved. It’s only written to your account once you approve it.
When you create or change a client, contact, project, budget, timecode or expense, the draft also shows what will be filled in for you, such as the currency and account manager a project takes from its client.
A draft can only be applied once, and one you don’t approve expires, so an old suggestion can never be actioned by accident. In Kea, the approval card lapses after 15 minutes. Through the MCP, a draft lasts 24 hours.
What it can see
Kea and the MCP only ever see what your own Projectworks login lets you see. Costs and margins stay hidden from anyone without permission to see them, and if an answer has been limited by your permissions, you’re told. The same applies to changes: they can only create or change something if your login is allowed to.
For more, see Security and data for Kea and the Projectworks MCP →