Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
---
title: Connect Grok to Expensify
description: Connect Grok to Expensify to search, retrieve, and analyze your Expensify data using the Expensify connector.
keywords: [Grok Expensify MCP, Grok AI, xAI, Grok connector, Grok custom connector, connect Grok to Expensify, Expensify MCP Grok setup]
internalScope: Audience is members using Grok. Covers connecting Grok to Expensify using Grok's connectors and MCP. Does not cover other AI clients or general MCP workflows.
order: 5
---

# Connect Grok to Expensify

Connect Grok to Expensify to search and analyze your Expensify data using natural language. Expensify is available as a built-in connector in Grok and uses MCP to securely connect Grok to your Expensify account.

## Who can connect Grok to Expensify

Any member with an Expensify account and a Grok account can connect Grok to Expensify.

## How to connect Grok to Expensify

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Step formatting: This is the article's primary "How to" workflow, but the instructions are prose. Per HELP_AUTHORING_GUIDELINES Section 5, procedural instructions should be sequential numbered steps. Consider converting the connect flow (open connectors, find Expensify, follow Grok's prompts to authorize) into numbered steps.

Follow Grok’s instructions to access available connectors: [Add a built-in connector](https://docs.x.ai/grok/connectors#built-in-connectors)

Find the **Expensify** connector, then follow Grok’s instructions to connect your Expensify account and complete setup.

## What happens after you connect Grok to Expensify

Once connected, Grok can search, retrieve, and analyze your Expensify data.

Grok can:

- Search expenses and reports
- Summarize spending
- Identify missing receipts
- Analyze spending trends

Grok cannot:

- Approve reports
- Edit expenses
- Reimburse payments
- Manage Workspace settings

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Terminology / consistency: Use lowercase "workspace settings" here. The companion MCP article uses lowercase "workspace" as a common noun (e.g., "manage workspace settings"), so "Manage Workspace settings" is inconsistent.


# FAQ

## Can I connect Grok to Expensify using a custom connector?

Yes. You can manually connect Grok to the Expensify MCP server instead of adding the Expensify connector from Grok.

For instructions, see Grok’s documentation: [Add a custom MCP connector ](https://docs.x.ai/grok/connectors#custom-mcp-connectors)

When prompted for the server URL, enter `https://www.expensify.com/mcp/`, then complete the OAuth sign-in and approval flow.

## How do I remove the Expensify connector from Grok?

To remove the Expensify connector, see Grok’s documentation: [Managing connectors](https://docs.x.ai/grok/connector-management#managing-connectors)

## Why can’t Grok access my Expensify data?

Make sure you completed the OAuth approval flow in your browser.

If Grok still cannot access your data:

- Verify the MCP server URL is correct, if using a custom connector.
- Remove the connector and add it again.

## Can Grok edit expenses or approve reports?

No. The Expensify connector provides Grok read-only access to your data.
Original file line number Diff line number Diff line change
@@ -1,21 +1,23 @@
---
title: Use the Expensify MCP server with AI assistants
description: Learn how to connect MCP-compatible AI assistants like ChatGPT, Claude, and Cursor to your Expensify account to securely search and analyze your Expensify data using natural language.
keywords: [connect AI assistants to Expensify, Expensify MCP server, ChatGPT Expensify integration, Claude Expensify MCP, MCP server setup, AI expense analysis]
internalScope: Audience is members, managers, accountants, and Workspace Admins using MCP-compatible AI clients. Covers connecting AI assistants to Expensify using the MCP server and understanding supported workflows, permissions, and security limitations. Does not cover client-specific MCP configuration steps or non-MCP integrations.
description: Connect an AI assistant to Expensify to securely search and analyze your Expensify data using the Expensify connector or MCP server.
keywords: [connect AI assistants to Expensify, Expensify MCP server, Expensify AI connectors, ChatGPT Expensify integration, Claude Expensify connector, Cursor Expensify MCP, Grok Expensify connector, AI expense analysis]
internalScope: Audience is members using MCP-compatible AI assistants. Covers connecting supported AI assistants to Expensify using built-in connectors or the Expensify MCP server, plus supported workflows, permissions, and security. Does not cover detailed client-specific configuration.
order: 1
---

# Use the Expensify MCP server with AI assistants

The Expensify MCP server lets you connect AI assistants like ChatGPT, Claude, and Cursor directly to your Expensify account. Once connected, you can ask questions about expenses, reports, reimbursements, receipts, trips, chats, tasks, invoices, and spending trends directly from your AI client.
Connect an AI assistant to Expensify to search and analyze your Expensify data using natural language. Once connected, you can ask questions about expenses, reports, reimbursements, receipts, trips, chats, tasks, invoices, and spending trends directly from your AI client.

Instead of manually exporting data or building custom reporting workflows, you can ask questions in natural language and get answers directly from your AI assistant.
ChatGPT, Claude, Cursor, and Grok offer built-in ways to connect to Expensify. You can also manually connect other MCP-compatible AI assistants using the Expensify MCP server.

## What is MCP?

MCP (Model Context Protocol) is an open standard that lets AI assistants securely connect to services like Expensify.

Expensify’s MCP server provides compatible AI assistants with Search functionality so they can retrieve and analyze Expensify data on your behalf.

Once connected, your AI assistant can:

- Search and analyze expenses
Expand All @@ -25,38 +27,42 @@ Once connected, your AI assistant can:
- Surface approval bottlenecks
- Answer natural language questions about your Expensify data

Expensify’s MCP server exposes Search functionality to compatible AI assistants, allowing them to retrieve and analyze Expensify data on your behalf.

## Who can connect AI assistants using Expensify’s MCP server
## Who can connect AI assistants to Expensify

Any member with an Expensify account and access to an MCP-compatible AI client can connect to the Expensify MCP server.
Any member with an Expensify account and access to a supported AI assistant or MCP-compatible AI client can connect to Expensify.

Supported AI clients include:

- Claude
- ChatGPT
- Cursor
- Grok
- Other MCP-compatible AI clients

## How to connect a supported AI assistant to Expensify

Other MCP-compatible AI clients may also work with the Expensify MCP server.
If you use ChatGPT, Claude, Cursor, or Grok, follow the setup guide for your AI assistant. These integrations provide a built-in way to connect to Expensify without manually configuring the Expensify MCP server.

## How to connect AI assistants using Expensify’s MCP server
- [Connect ChatGPT to Expensify](/articles/new-expensify/connections/connect-ai-assistants/Connect-ChatGPT-to-Expensify-Using-MCP)
- [Connect Claude to Expensify](/articles/new-expensify/connections/connect-ai-assistants/Connect-Claude-to-Expensify-Using-MCP)
- [Connect Cursor to Expensify](/articles/new-expensify/connections/connect-ai-assistants/Connect-Cursor-to-Expensify-Using-MCP)
- [Connect Grok to Expensify](/articles/new-expensify/connections/connect-ai-assistants/Connect-Grok-to-Expensify)

Each AI client has its own MCP configuration flow, but the general setup process is similar.
## How to manually connect an AI assistant using Expensify’s MCP server

If your AI assistant supports custom MCP connections, you can manually connect it to the Expensify MCP server.

The exact setup varies by AI client, but the general process is:

1. Open your MCP-compatible AI client.
2. Locate the MCP or integrations settings.
3. Add a new MCP server connection.
4. Connect to `https://www.expensify.com/mcp`.
2. Locate its MCP, connector, or integrations settings.
3. Add a new MCP server or custom connector.
4. Enter `https://www.expensify.com/mcp/` as the server URL.
5. Sign in to Expensify when prompted.
6. Review the requested permissions.
7. Approve the OAuth access request.
8. Return to your AI client and test the connection using a natural language query.

Supported setup guides:
- [Connect ChatGPT to Expensify using MCP](/articles/new-expensify/connections/connect-ai-assistants/Connect-ChatGPT-to-Expensify-Using-MCP)
- [Connect Claude to Expensify using MCP](/articles/new-expensify/connections/connect-ai-assistants/Connect-Claude-to-Expensify-Using-MCP)
- [Connect Cursor to Expensify using MCP](/articles/new-expensify/connections/connect-ai-assistants/Connect-Cursor-to-Expensify-Using-MCP)

## What you can do with Expensify’s MCP server

You can use natural language to query and analyze your Expensify data through your AI assistant.
Expand Down Expand Up @@ -101,27 +107,29 @@ When connecting:
3. Expensify shows a consent screen explaining the requested access.
4. You approve or deny the connection.

When you authorize the connection, you grant the `mcp:tools` scope. This gives the AI assistant read access to the Expensify data you can already access based on your account and Workspace permissions.
When you authorize the connection, you grant the `mcp:tools` scope. This gives the AI assistant read access to the Expensify data you can already access based on your account and workspace permissions.

The MCP server provides read-only access to Expensify data through the Search tool. Your AI assistant can search, retrieve, and analyze data, but it cannot create, edit, or delete anything in Expensify.

You can revoke access at any time.

## How to revoke access to Expensify’s MCP server
## How to revoke an AI assistant’s access to Expensify

You can disconnect your AI assistant from Expensify at any time.

To revoke access:
If you connected Expensify using a built-in connector, follow the instructions for your AI assistant to remove or disconnect the Expensify connector.

If you manually configured the Expensify MCP server:

1. Open the AI client you connected to Expensify.
2. Locate the MCP or integrations settings.
3. Remove or disconnect the Expensify MCP server connection.

You may also revoke access directly through Expensify’s OAuth revocation flow if supported by your client configuration.
You may also revoke access directly through **Device management** in your Expensify account if supported by your AI client. [Learn how to managed logged in devices](/articles/new-expensify/settings/Manage-Logged-in-Devices).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Anchor text grammar / typo: "Learn how to managed logged in devices" should read "Learn how to manage logged-in devices" to match the linked article and the descriptive anchor-text standard. Also remove the trailing space at the end of the line.


After revocation, the AI assistant will no longer be able to access your Expensify data through MCP.

## What happens after you connect AI assistants using Expensify’s MCP server
## What happens after you connect an AI assistant to Expensify

Once connected, your AI assistant can use Expensify’s MCP Search tool to retrieve and analyze your searchable Expensify data in response to natural language prompts.

Expand All @@ -139,7 +147,9 @@ The MCP server supports read-only workflows focused on:

## Which AI assistants work with Expensify’s MCP server?

Any MCP-compatible AI client may work with Expensify’s MCP server. Official setup guides are available for Claude, ChatGPT and Cursor.
ChatGPT, Claude, Cursor, and Grok can connect to Expensify using their built-in Expensify integrations.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Distinguish custom MCP setups from built-in integrations

This incorrectly says all four clients have built-in Expensify integrations. The linked Claude guide explicitly requires users to add a custom connector and enter the MCP URL (Connect-Claude-to-Expensify-Using-MCP.md, lines 25–34), while the Cursor guide offers an MCP install link or manual server configuration (Connect-Cursor-to-Expensify-Using-MCP.md, lines 29–39). Users may therefore look for nonexistent built-in integrations; classify each client according to its actual setup flow instead.

Useful? React with 👍 / 👎.


Other MCP-compatible AI clients may also work with the Expensify MCP server by connecting to `https://www.expensify.com/mcp/`.

## What data can Expensify’s MCP server access?

Expand All @@ -156,7 +166,7 @@ The MCP server can access data available through Expensify’s Search tool, incl

## Can Expensify’s MCP server approve reports or edit expenses?

No. The Expensify MCP server provides read-only access to your data. It can search, filter, summarize, and analyze information, but it cannot approve reports, edit expenses, reimburse payments, or manage Workspace settings.
No. The Expensify MCP server provides read-only access to your data. It can search, filter, summarize, and analyze information, but it cannot approve reports, edit expenses, reimburse payments, or manage workspace settings.

## Are the documented prompts the only supported use cases?

Expand All @@ -167,7 +177,3 @@ Many similar analytical and search-based workflows may also work depending on th
## Is my data secure when using Expensify’s MCP server?

Yes. Expensify uses OAuth 2.1 with PKCE and explicit user consent to authorize AI assistant connections. You can revoke access at any time.

## What happens after I connect my AI assistant?

Once connected, your AI assistant can use Expensify’s MCP Search tool to retrieve and analyze your searchable Expensify data in response to natural language prompts.
Loading