Expensify MCP Server

Expenses, receipts and reports in Expensify.

Hosted MCP Server

npx add-mcp 'https://cotlet.dev/mcp/v1/expensify'

Installs into Claude Code, Codex, Cursor and more

Documentation

Cotlet · Integrations · How it works · Security · For developers · For automation agencies · Blog · API docs · Help center · Changelog · Contact · Pricing · Sign up

Expensify API and MCP server: Let your AI agent clear the Expensify queue.

Expensify runs its own MCP server at expensify.com/mcp, with one Search tool, and says "Access is read-only at launch" (24 Jun 2026, unchanged on 27 Oct 2026). Its Integration Server API creates expenses and exports reports but has no job to submit, approve, reject or attach a receipt. Cotlet runs 14 Expensify tools hosted, over MCP for agents and REST for scripts, including those four.

Expenses, receipts and reports in Expensify. Use it in ChatGPT, Claude or any AI agent over MCP, or in n8n, Make and scripts over REST.

MCP setup REST API guide

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by Expensify. Expensify is a trademark of its owner. If Expensify's own integrations cover what you need, use them first.

What can you automate in Expensify?

  • Create expenses from a folder of receipts
  • Build and submit the weekly report
  • Approve small reports by your rule
  • Reject reports missing a receipt
  • Find expenses with no receipt
  • Export approved reports for the bookkeeper

Does Expensify have an MCP server or an API?

  • The official MCP signs in with OAuth and answers questions like "Which expense reports need my approval?". Expensify's own words: it "cannot approve bills, edit transactions, lock cards, or move money."
  • The Integration Server takes partner credentials you generate yourself, allows 5 requests every 10 seconds, and creates a report only for domain and policy admins after Concierge enables it. Its status updater only moves Approved reports to Reimbursed.
  • Zapier has 1 trigger (New Report) and 3 actions: create an expense, create a report (Premium users only) and export a PDF. n8n has no Expensify node.
What you needExpensify MCPIntegration Server APICotlet
Search expenses and reportsYesExport by ID or dateYes, with filters
Create an expenseNoYesYes, after your OK
Attach a receipt imageNoNoYes
Submit a reportNoNoYes, after your OK
Approve or reject a reportNoNoYes, after your OK
What you need firstAny accountPartner keys, admin rightsYour own login

Checked 27 Oct 2026. Sources: Expensify blog: the Expensify MCP server (24 Jun 2026), Expensify Integration Server: API reference, Expensify on Zapier, Understand Expensify Pricing (Expensify Help)

How does Cotlet connect to Expensify?

  1. Sign in to Expensify. Use your own account in its Cotlet Cloud Browser.
  2. Choose MCP or REST. Connect your agent or create a Cotlet API key.
  3. Run your workflow. Ask your agent or send an HTTP request.

Expensify has no password for us to keep, and every expense, submission, approval and rejection waits for your OK.

Connect Expensify to your agent or workflow

Use MCP with your AI agent, or HTTP requests in n8n, Make, Zapier and scripts. Follow the MCP setup below or jump to the REST guide.

  1. Sign in to Expensify in a Cloud Browser. Create a Cotlet account, open Expensify in its Cloud Browser, sign in with your email and the security code Expensify sends you, then press Enable for agents.
  2. Add the Cotlet address. Put https://cotlet.dev/mcp/v1 into the MCP server or connector settings of your agent.
  3. Allow the connection. Chat apps send you to a Cotlet sign-in page. Code editors, n8n and scripts use an API key from the console.

https://cotlet.dev/mcp/v1 carries every app you connect to Cotlet. Expensify's own MCP server can sit next to it in the same client; the tool names do not clash. If you enable Expensify after connecting, refresh the connector.

Claude:

Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect

Claude Code:
claude mcp add --transport http cotlet \
  https://cotlet.dev/mcp/v1 \
  --header "Authorization: Bearer $COTLET_API_KEY"

ChatGPT:

Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth

Cursor:

// ~/.cursor/mcp.json
{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
    }
  }
}

Codex:

# ~/.codex/config.toml
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"

n8n:

MCP Client Tool (inside an AI Agent)
Transport: HTTP Streamable
URL: https://cotlet.dev/mcp/v1
Auth: Bearer, <your key>
Tool: expensify_read

Make, Zapier:

Make: MCP Client > Call a tool
Zapier: MCP Client by Zapier > Run Tool
Server URL: https://cotlet.dev/mcp/v1
Token: <your key>
Tool: expensify_write

How to use the Expensify REST API

Create your Cotlet API key

Create a Cotlet API key with access to Expensify and its read operations. Store it as COTLET_API_KEY in your environment or automation platform's credential store.

Connect Expensify in Cotlet and enable it for agents. Account access: Your own Expensify account (a workspace admin or the assigned approver to approve reports; any member to create expenses and submit).

Make your first Expensify API request

REST:

curl https://cotlet.dev/api/v1/expensify/workspaces \
  -H "Authorization: Bearer $COTLET_API_KEY"

Read workspaces and apply the operation limits

A successful REST call puts the tool output in result. This illustrative response excerpt omits call IDs, messages and credit details.

Illustrative response excerpt:

{
  "status": "success",
  "app": "expensify",
  "tool": "list_workspaces",
  "result": {
    "workspaces": [
      {
        "workspace_id": "W3A91C",
        "name": "Acme Studio",
        "currency": "USD",
        "role": "admin"
      },
      {
        "workspace_id": "W7D20F",
        "name": "Acme Contractors",
        "currency": "USD",
        "role": "member"
      }
    ]
  }
}

Returns each workspace with its name, ID, default currency and your role (admin, approver or member). Use the name or ID as the workspace parameter in the other tools.

It shows only workspaces your account can open.

Keep the same selection when continuing a list. Compare changed record values as well as identifiers when refreshing your destination.

Expensify workflows for agents and automations

ToolConnect throughExample workflow
n8nHTTP RequestReports with status, total, submitter and approver, newest first. Use list_reports in your configured operations sheet.
MakeHTTP > Make a requestOne report with its expenses, receipts, holds and comments. Use get_report in your configured operations sheet.
Python or Node.jsREST APIExpenses with merchant, amount, category, receipt flag and report, newest first. Use list_expenses in your configured operations sheet.

Send Authorization: Bearer <your Cotlet API key> in request headers. You configure the schedule, destination and record comparisons.

Cotlet reads Expensify; your workflow steps write to your chosen destination. These HTTP workflows do not require a native Cotlet connector or a prebuilt template.

Python and Node.js can use the same HTTP requests without an AI agent. Keep access keys in credentials, outside shared workflow exports.

The API and MCP reference lists operations and inputs. The REST API guide explains authentication, errors and approvals.

Expensify API endpoints and MCP tools

Expenses and receipts

Expenses land in your own account, off any report. On an Approved report only a Workspace Admin can attach or replace a receipt.

  • List expenses (list_expenses, read): Expenses with merchant, amount, category, receipt flag and report, newest first.
  • Get expense (get_expense, read): One expense with all fields, the receipt link and its report.
  • Create expense (create_expense, write, asks first): Creates an expense in a workspace with merchant, date, amount, currency and category.
  • Attach receipt (attach_receipt, write): Adds a receipt image or file to an expense, or replaces the one on it.

Reports

Only your own expenses go on your draft. Held expenses move to a new draft when the rest is submitted.

  • List reports (list_reports, read): Reports with status, total, submitter and approver, newest first.
  • Get report (get_report, read): One report with its expenses, receipts, holds and comments.
  • Create report (create_report, write): Creates an empty draft report in a workspace.
  • Add expense to report (add_expense_to_report, write): Puts an existing expense of yours on a draft report.
  • Submit report (submit_report, write, asks first): Submits a draft report to the workspace approval workflow.
  • Export report (export_report, read): A report as CSV or PDF, with an expense-level or report-level template.

Approvals

For the assigned approver, or a Workspace Admin who bypasses the workflow. A rejection needs a comment.

  • Approve report (approve_report, write, asks first): Approves a submitted report you are the approver for.
  • Reject report (reject_report, write, asks first): Sends a submitted report back to its submitter with a comment.

Workspaces

Read the categories and tags first, so new expenses only use values the workspace has.

  • List workspaces (list_workspaces, read): Workspaces your Expensify account belongs to, with your role in each.
  • Get workspace (get_workspace, read): Categories, tags and approval setup of one workspace.

Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/expensify-api-mcp-server#tools

Who can see my Expensify session, and how do I revoke it?

  • What we store. Your signed-in Expensify profile, AES-256-GCM, in Finland. Expensify uses no password.
  • What your agent gets. 14 Expensify tools. No cookie, no security code.
  • What the session sees. What your Expensify role sees: your own expenses, or the reports you approve.
  • What no tool touches. Payments, reimbursement, the Expensify Card, bank accounts and workspace settings.
  • If Expensify signs you out. We email you a link. You enter the new security code, we never do.
  • How to cut access. Disable for agents, reset the browser or delete the key. The next call fails.

On a work email, a Domain Admin can report suspicious activity and lock your Expensify account, so tell yours before you connect it. The Cotlet site has A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory (live results).

Approvals, undo and mistakes

  1. Reads the queue. Reports waiting for you, with total, submitter and a hold flag.
  2. Checks each line. Receipt and hold on every expense, not just the report total.
  3. Waits for your OK. Each approval or rejection waits in your Cotlet console.
  4. Reports back. Approved, rejected with the reason, and left for you.
ActionUndo
Approve a reportUnapprove it, until it is Paid or Done
Reject a reportThe submitter fixes and resubmits; your comment stays
Submit a reportRetract it; only the submitter can
Create an expenseDelete it in Expensify by hand; no tool deletes
Attach a receiptReplace it; the "added a receipt" message stays

4 of the 7 write tools ask first. attach_receipt, create_report and add_expense_to_report run at once, because a receipt or a draft reaches nobody until the report goes out. Reads run at once. For a scheduled run you can turn the wait off per tool.

With Prevent Self-Approval on, Expensify stops an admin from approving their own report, and the agent cannot get round that either.

MCP call:

{
  "name": "create_expense",
  "arguments": {
    "workspace": "Acme Studio",
    "amount": 42.5,
    "currency": "USD",
    "merchant": "Blue Bottle Coffee",
    "date": "2026-10-12",
    "category": "Meals",
    "description": "Coffee with client before the Northwind kickoff"
  }
}

REST:

curl -X POST https://cotlet.dev/api/v1/expensify/expenses \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"workspace":"Acme Studio","amount":42.5,"currency":"USD","merchant":"Blue Bottle Coffee","date":"2026-10-12","category":"Meals","description":"Coffee with client before the Northwind kickoff"}'

Response:

{
  "expense_id": "T7f3a9c",
  "workspace": "Acme Studio",
  "merchant": "Blue Bottle Coffee",
  "date": "2026-10-12",
  "amount": 42.5,
  "currency": "USD",
  "category": "Meals",
  "description": "Coffee with client before the Northwind kickoff",
  "reimbursable": true,
  "has_receipt": false,
  "report_id": null,
  "created_at": "2026-10-14T09:31:00+02:00"
}

A receipt script or a month-end job can call the same tools over REST at /api/v1/expensify, with one key and one price. A call your Expensify role cannot make returns an error and costs nothing. Every tool row above lists its REST path.

How much does the Expensify MCP server cost?

About $23 a month for one approver in a 14-member workspace, 4,040 credits. Expensify Collect is $5 a member a month on top.

JobCallsCredits
Receipts into expenses, 3 at a time, twice a week7 × 8560
Weekly report built and submitted10 × 4400
Approve or reject by rule, each workday6 × 221,320
Expenses missing a receipt, weekly3 × 4120
Approved reports exported for the bookkeeper14 × 1140
Cloud Browser, 30 days1,500
Total4,040
  • Free 7-day trial, no card
  • 10 credits per successful call, MCP or REST
  • 50 credits a day for the Cloud Browser
  • Works on Collect or Control

Expensify's Q2 2026 results give 640,000 paid members across 45,700 companies, about 14 a company. The month is one approver there: 6 receipts a week, one weekly report, the approval queue each workday, a weekly receipt check and one month-end export. Dollars at the $29 pack rate.

Expensify MCP server on GitHub, Zapier or hosted: which to use

OptionWhat it doesWhere it stops
BilalAtique/expensify-mcp17 tools on the Integration Server: expenses, reports, categories, tags, members, expense rules. MIT, 0 stars, last push 24 Sep 2026.Its README: "There is no approve endpoint." No submit, no receipt upload; your partner keys in a local file.
magarcia/expensify-cliA Go CLI on New Expensify's private app API: receipts, report submit and approve, with an agent skill. MIT, 1 star, created 17 Oct 2026.Runs on your computer; it warns the app API "can change without notice".
Merge Agent Handler, GumloopHosted MCP tools on your Integration Server keys: create expenses and reports, export reports, card transactions.Same API limits: no submit, approve or receipts.

Use Expensify's own MCP server if questions about spend are all you need; it is free and official. Use the Integration Server or a GitHub server on it if you are a domain admin who pushes expenses in from another system. Use Cotlet if your agent should attach receipts, submit and approve without you running anything.

Also listed on: Odel, mcpbeat

Who runs Cotlet

Take Group sp. z o.o. runs Cotlet. It is a software company registered in Poland, EU (VAT PL6342984273), in business since 2019, founded by Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Questions about the Expensify tools go to contact@cotlet.dev.

Expensify API and MCP: questions

How do I get access?

Sign up free at https://cotlet.dev, open Expensify under Integrations in the console and sign in to Expensify in its Cloud Browser. The trial starts when you sign up and needs no card.

How do I connect Expensify to ChatGPT or Claude?

Sign up at cotlet.dev, log in to Expensify once in its Cloud Browser and add Cotlet to ChatGPT or Claude, following the steps in your console. No API key is needed. ChatGPT and Claude then work in your Expensify account through Cotlet, in their phone apps too.

What can ChatGPT do in Expensify?

With Cotlet, ChatGPT, Claude and other AI agents handle jobs like these in Expensify: create expenses from receipts; create and submit the weekly expense report; approve small expense reports by rule. You ask in plain words, and anything that reaches other people waits for your OK first.

Do I need to be a workspace admin?

No for creating expenses and submitting your own reports: any member can. Approving needs you to be the assigned approver, or a Workspace Admin who bypasses the workflow, and Expensify blocks an admin from approving their own report when Prevent Self-Approval is on.

Can I use it next to Expensify's own MCP server?

Yes. Expensify's server answers questions through its Search tool; Cotlet's tools make the changes. Both can be connected in the same client.

Does it work with Expensify Classic?

The tools work in New Expensify at new.expensify.com. Expensify said more than 56% of its users were on New Expensify in Q2 2026.

Does Expensify have webhooks?

No. The Integration Server sends nothing out, and Zapier's one trigger, New Report, is polled. To react to new reports, run your agent on a schedule and read the queue.

Is the MCP server different from the REST API?

Only in how you call it. Both have the same 14 tools, inputs and answers, one API key and one price. Agents use MCP; scripts and cron jobs use REST.

Is Cotlet affiliated with Expensify?

No. Cotlet is independent and not affiliated with Expensify, Inc.

Can I use the Expensify API without an AI agent?

Yes. Call Cotlet's REST API from a script or an HTTP step in n8n, Make or Zapier with your Cotlet key. MCP is the alternative for AI agents; you do not need to connect an agent to use REST.


Give your AI agents your signed-in browser.

Product: Integrations · How it works · Pricing · Security

Resources: Blog · API docs · Help center · Changelog · GitHub

Solutions: For developers · For automation agencies

Company: About · AI info: company facts · Contact

Legal: Terms of service · Privacy policy · Refund policy · Acceptable use · Cookie policy · DPA · Subprocessors

Elsewhere: Status page · Cotlet on GitHub · Cotlet on X · Cotlet on LinkedIn · Cotlet on Product Hunt · Cotlet on Crunchbase · Cotlet on SaaSHub

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. About us

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.