Integration

Rydoo integration

Rydoo is a travel and expense management platform. Create expenses for users with uploaded receipts, read single and exported expenses, report, unreport, reject or reimburse expenses, manage users with their groups, approvers and controllers, groups, projects and their approvers and controllers, trips and trip statuses, card transactions, list-type custom field items, guests and external organizations, branch exchange rates, and read branches, categories, reimbursements and payment methods. Payment method creation and editing (card numbers), approval-line, role and permission administration, linked-account delegations and the receipt PDF download are not exposed. Authentication is OAuth 2.0 client credentials: create a client ID and secret under Admin, API Credentials in Rydoo (API access must be enabled on the account); calls go to the production API (api.rydoo.com), not the sandbox.

Connect Rydoo How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Rydoo.Built from the 61 Rydoo tools below, on the connection you add once.

What you can do with Rydoo

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Count, 7 operations

count_custom_field_itemsCount custom field itemsGETReturns how many items a list-type custom field has, optionally matching a name or external id search.
count_groupsCount groupsGETReturns how many groups match the given filters (name search, branch, parent group, active state).
count_payment_methodsCount payment methodsGETReturns how many payment methods match the given filters (account type, branch, card type, ownership, validation status, reimbursable flag, user).
count_projectsCount projectsGETReturns how many projects match the given name search and active state.
count_reimbursementsCount reimbursementsGETReturns how many reimbursements match the given modification date range and status.
count_transactionsCount transactionsGETReturns how many card transactions match the given payment method type, status, match status and date range.
count_tripsCount tripsGETReturns how many trips match the given user, name search, status and active state.

Group, 6 operations

create_groupCreate groupPOSTAdds a group (department) to the company with a name, reference id, branch, optional parent group, active flag and ignoreApproval flag.
get_groupGet groupGETReturns one group (department): name, reference id, branch, parent group, active flag and ignoreApproval flag.
list_groupsList groupsGETLists the groups (departments) of the company, optionally filtered by name, branch, parent group and active state; loadAllLevels returns nested groups too. Paginate with limit and offset.
list_user_groupsList user groupsGETLists the groups a user belongs to, each with the date the user entered and left it.
set_user_groupsSet user groupsPUTSets the groups a user belongs to: each item names a group and the dates the user enters and leaves it. Returns the resulting memberships.
update_groupUpdate groupPUTUpdates a group (department): name, reference id, branch, parent group, active flag and ignoreApproval flag. Returns the updated group.

Listitem, 4 operations

create_custom_field_itemCreate custom field itemPOSTAdds an item to a list-type custom field with a name, external id, status, billing legal entity, branch or project limitation and default groups.
get_custom_field_itemGet custom field itemGETReturns one item of a list-type custom field: name, external id, status, billing legal entity, limitations and default groups.
list_custom_field_itemsList custom field itemsGETLists the items of a list-type custom field, optionally searched by name or external id (prefix or exact match). Paginate with limit and offset.
update_custom_field_itemUpdate custom field itemPUTUpdates an item of a list-type custom field: name, external id, status, billing legal entity, limitations and default groups. Returns the updated item.

Project, 4 operations

create_projectCreate projectPOSTAdds a project to the company with a name, reference id, branch, the groups it is limited to or default for, and custom field values.
get_projectGet projectGETReturns one project: name, reference id, active flag, branch, the groups it is limited to and default for, and its custom field values.
list_projectsList projectsGETLists the projects of the company, optionally filtered by name and active state. Paginate with limit and offset.
update_projectUpdate projectPUTUpdates a project: name, reference id, active flag, branch, limited-to and default-for groups, and custom field values. Returns the updated project.

Trip, 4 operations

create_tripCreate tripPOSTCreates a trip for a user with a name, comment, destinations, custom fields and budget; submitForApproval submits it right away. Returns the new trip.
get_tripGet tripGETReturns one trip: owner, name, comment, status, destinations, custom fields, attachments, budget, total spent and whether it has per diem expenses.
list_tripsList tripsGETLists the trips of the company, optionally for one user, filtered by name, status, active state and date range, with destinations, total spent and number of expenses. Paginate with limit and offset.
update_tripUpdate tripPUTUpdates a trip: name, comment, active flag, reference id, destinations, custom fields and budget; submitForApproval submits it. Returns the updated trip.

User, 4 operations

create_userCreate userPOSTAdds a user to the company with email, name, reference id, authentication type (Password or Sso), country, language, group, reimbursement account and custom fields. An enabled user receives a verification email.
get_userGet userGETReturns one user of the company: status, email, name, reference id, authentication type, country, language, reimbursement account, commuter distance and custom fields.
search_usersSearch usersGETSearches the users of the company by free text, email, first or last name, external id, or whether they have a card. Paginate with limit and offset.
update_userUpdate userPUTUpdates a user of the company: status, email, name, reference id, authentication type, country, language, reimbursement account, commuter distance and custom fields. Returns the updated user.

Approver, 2 operations

get_project_approversGet project approversGETReturns the approvers and conflict approvers assigned to a project.
set_project_approversSet project approversPUTSets the approvers and conflict approvers of a project and returns the resulting assignment.

Branch, 2 operations

get_branchGet branchGETReturns one branch (legal entity) of the company: name, enterprise number, reference and external ids, currency and address.
list_branchesList branchesGETLists the branches (legal entities) of the company with currency, country and reference id, optionally filtered by name or id search and active state. Paginate with limit and offset.

Category, 2 operations

get_categoryGet categoryGETReturns one expense category: name, accounting numbers, branch, parent category, active flag, expense types it applies to and groups it is limited to.
list_categoriesList categoriesGETLists the expense categories of the company, optionally filtered by name, branch, parent category and active state. Paginate with limit and offset.

Controller, 2 operations

get_project_controllersGet project controllersGETReturns the controllers and conflict controllers assigned to a project.
set_project_controllersSet project controllersPUTSets the controllers and conflict controllers of a project and returns the resulting assignment.

Customfield, 2 operations

get_custom_fieldGet custom fieldGETReturns one custom field: name, external id, where it is used, type, whether it is required or read-only, status and its role, branch and category limitations.
list_custom_fieldsList custom fieldsGETLists the custom fields defined for the company, with where each is used, its type and status.

Expense, 2 operations

create_expenseCreate expensePOSTCreates a regular expense for a user (userId is mandatory): amount, currency, date, merchant, category, group, project, trip, payment method, custom fields, and a receiptId from upload_receipt. Returns the new expenseId.
get_expenseGet expenseGETReturns one expense by its UUID: owner, status, amount and currency, date, merchant, category, group, project, trip, receipt, custom field values, attendees and exchange rates; Currencies (up to 3) adds converted amounts.

Expenseapprover, 2 operations

get_user_expense_approversGet user expense approversGETReturns the users assigned to approve the expenses of a user.
set_user_expense_approversSet user expense approversPUTSets the users who approve the expenses of a user and returns the resulting assignment.

Expensecontroller, 2 operations

get_user_expense_controllersGet user expense controllersGETReturns the users assigned as controllers (second approval level) for the expenses of a user.
set_user_expense_controllersSet user expense controllersPUTSets the users who control (second approval level) the expenses of a user and returns the resulting assignment.

External organization, 2 operations

create_external_organizationCreate external organizationPOSTCreates an external organization (the company a guest belongs to) by name.
list_external_organizationsList external organizationsGETLists external organizations (the companies guests belong to), optionally searched by name. Paginate with limit and offset.

Transaction, 2 operations

create_transactionCreate transactionPOSTAdds a card transaction for a user: uniqueId, userId, original and billed currency and amount, paymentMethodId and transactionDate are required; merchant, location and category code are optional.
list_transactionsList transactionsGETLists card transactions (the lines of a card statement) of the company, filtered by payment method type, status, match status and transaction date range, with the expenses they matched. Paginate with limit and offset.

All, 1 operation

list_payment_methodsList payment methodsGETLists the payment methods (cards, cash, transfer...) of the company, filtered by account type, branch, card type, ownership, validation status, reimbursable flag or user. Paginate with limit and offset.

Changestatus, 1 operation

change_trip_statusChange trip statusPOSTChanges the status of a set of trips at once, for example to Approved, Rejected or Completed.

Company, 1 operation

create_guestCreate guestPOSTCreates a company-wide guest that every user can add as an attendee on an expense; fullName and externalOrganizationId are required, email is optional.

Exported, 1 operation

list_exported_expensesList exported expensesGETLists exported expenses with their booking detail (amounts, tax, category, project, owner, receipt URL), filtered by export date range, branch, trip, user or group; page with limit and startingAfter (last expense id).

Get active branch rate, 1 operation

get_branch_exchange_ratesGet branch exchange ratesGETReturns the custom exchange rates active for a branch on a given date, with their validity period.

Receipt, 1 operation

upload_receiptUpload receiptPOSTUploads a receipt file (JPG, PNG or PDF, at most 20 MB, PDF at most 15 pages) for a user and returns its id, to pass as receiptId to create_expense.

Reimburse, 1 operation

reimburse_expensesReimburse expensesPUTSets a set of expenses to Reimbursed; each item takes an expenseId and an optional paymentReference. Returns a result per expense.

Reimbursement, 1 operation

list_reimbursementsList reimbursementsGETLists reimbursements paid to users, with amount, status (InProgress, Succeeded, Failed or Cancelled), date and the expenses each covers, filtered by modification date range and status. Paginate with limit and offset.

Reject, 1 operation

reject_expensesReject expensesPOSTRejects a set of expenses by their ids, with an optional reject reason id and free-text message; returns a result per expense. A Reported expense must be unreported before it can be rejected.

Report, 1 operation

report_expenseReport expensePUTSets an expense to Reported, meaning it was booked in your accounting system. With one approval level the expense must be Approved first, with a controller level Controlled.

Sync branch exchange rate, 1 operation

set_branch_exchange_ratesSet branch exchange ratesPOSTDefines custom exchange rates for a branch over a period from startDate to expirationDate (the two dates must differ). Returns the creation date.

Unreport, 1 operation

unreport_expenseUnreport expensePUTUnreports an expense that is in status Reported, for example so that it can then be rejected.

Use Rydoo from Claude Code, Cursor or Codex

Connect Rydoo in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Rydoo operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Rydoo

Create your workspace
Sign up free. Nothing to install.
Connect Rydoo once
Add your Rydoo connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.