--- title: "Connecting Payhawk to your AI Assistant - Payhawk Help Center" slug: "connecting-payhawk-mcp" description: "Connect the Payhawk MCP to Claude, ChatGPT, Cursor, Notion, and the other supported AI Assistants, using the MCP server URL and your own Payhawk login." updated: 2026-11-09T09:19:58Z published: 2026-11-09T09:19:58Z canonical: "payhawk.com/connecting-payhawk-mcp" --- > ## Documentation Index > Fetch the complete documentation index at: https://payhawk.com/help/llms.txt > Use this file to discover all available pages before exploring further. # Connecting Payhawk to your AI Assistant The Payhawk MCP connects your Payhawk account to your AI Assistant, so you can ask about your live Payhawk data and act on it in the AI Assistant you already use, such as Claude, ChatGPT, or Cursor, using your own login and permissions. ## Before you start To connect the Payhawk MCP, you need: - An active Payhawk account. Sign in with the same credentials you use for the [Payhawk Web Portal](http://portal.payhawk.com/). - The Payhawk MCP server URL ([https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp), also available in the following sections). Each person signs in with their own Payhawk login, so everyone keeps their own Payhawk permissions. You stay signed in while you use the connection. You need to sign in again after 7 days without use, and every 30 days at most. ## Supported AI assistants The following table lists the AI Assistants Payhawk MCP supports: | AI Assistant | Made by | Good to know | | --- | --- | --- | | [Claude](/help/connecting-payhawk-mcp#connecting-to-claude) | Anthropic | Web, desktop and mobile apps. Listed in the Claude connector directory. On a Team or Enterprise plan, a Claude Owner has to enable Payhawk first. | | [Claude Code](/help/connecting-payhawk-mcp#connecting-to-claude-code) | Anthropic | Set up in a terminal. | | [ChatGPT](/help/connecting-payhawk-mcp#connecting-to-chatgpt) | OpenAI | Listed in the ChatGPT plugin directory, on every plan including Free. | | [Codex CLI](/help/connecting-payhawk-mcp#connecting-to-codex) | OpenAI | Set up in a terminal. To use the Codex desktop app, follow the ChatGPT steps. UI components show as text. | | [Cursor](/help/connecting-payhawk-mcp#connecting-to-cursor) | Anysphere | Set up in your `mcp.json` file. | | [GitHub Copilot app](/help/connecting-payhawk-mcp#connecting-to-the-github-copilot-app) | GitHub | | | [GitHub Copilot in VS Code](/help/connecting-payhawk-mcp#connecting-to-github-copilot-in-vs-code) | GitHub | Set up from the Command Palette. | | [Microsoft Copilot Studio](/help/connecting-payhawk-mcp#connecting-to-microsoft-copilot-studio) | Microsoft | | | [Microsoft 365 Copilot](/help/connecting-payhawk-mcp#connecting-to-microsoft-365-copilot) | Microsoft | A Microsoft 365 administrator has to approve the Payhawk agent. | | [Langdock](/help/connecting-payhawk-mcp#connecting-to-langdock) | Langdock | | | [Notion](/help/connecting-payhawk-mcp#connecting-to-notion) | Notion | | | [Dust](/help/connecting-payhawk-mcp#connecting-to-dust) | Dust | | > [!TIP] > Payhawk accepts sign-ins only from the AI Assistants in the table. In any other app, the sign-in fails with an error that mentions `host-not-allowed` or “The client redirect URI is not allowed.” To request support for another app, contact Payhawk Support at [support@payhawk.com](mailto:support@payhawk.com). ## Connecting to Claude Claude supports the Payhawk MCP on the web, in the desktop app, and in the mobile app. You can connect Payhawk from the Claude connector directory: 1. Open [Payhawk’s listing in the Claude Marketplace](https://claude.com/marketplace/connectors/payhawk). 2. Click **Add to Claude** and follow the prompts to connect. 3. Sign in with the credentials you use for the [Payhawk Web Portal](http://portal.payhawk.com/) and approve the connection. If you use Claude on a Team or Enterprise plan, a Claude Owner must enable the connector first. Each person then connects with their own Payhawk login and keeps their own Payhawk permissions. You can also add Payhawk as a custom connector, with the Payhawk MCP server URL. First, check whether you can add connectors yourself. - Custom connectors work on every Claude plan (Free, Pro, Max, Team, and Enterprise; Free allows one), so the plan is rarely the blocker. - On a personal Free, Pro, or Max account, you can add Payhawk yourself. - On a Team or Enterprise workspace, only a Claude Owner can add a custom connector, so ask yours to add Payhawk once and then connect to it individually. Being a Payhawk Administrator makes no difference here; this is a Claude permission, not a Payhawk one. If you add it yourself (Free, Pro, Max): 1. In the Claude desktop app, go to **Settings** > **Connectors**. 2. Click **Add custom connector**. 3. Enter a name, for example **Payhawk**, and the Payhawk MCP server URL [https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp). 4. Leave the options Claude marks as **Detected**: **Sign in now** under **Authentication** and **Register automatically** under **OAuth client**. 5. Sign in with your Payhawk credentials when prompted. You can also add Payhawk from the Claude mobile app, on the same screen. If your Claude Owner adds it (Team, Enterprise): 1. The Owner goes to **Organization settings** > **Connectors**, clicks **Add**, hovers **Custom**, and picks **Web**. 2. The Owner pastes the [https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp) Payhawk MCP server URL and clicks **Add**. 3. Everyone else goes to **Settings** > **Connectors**, finds Payhawk, clicks **Connect**, and signs in with their own Payhawk login. Each person signs in as themselves, so everyone keeps their own Payhawk permissions. Payhawk now appears in your Claude tools. ## Connecting to Claude Code To connect Payhawk to Claude Code: 1. In a terminal, run `claude mcp add --transport http payhawk https://mcp.payhawk.com/mcp`. To make Payhawk available in all your projects instead of only the current one, add `--scope user`. 2. Start Claude Code and type `/mcp`. 3. Select **payhawk** and follow the steps in your browser to sign in with your Payhawk login. You can also sign in from the terminal with `claude mcp login payhawk`, and sign out with `claude mcp logout payhawk`. Non-interactive runs (`claude -p`) can’t complete the sign-in, so sign in once from an interactive session first. If you remove the server with `claude mcp remove payhawk`, your saved sign-in is removed too. ## Connecting to ChatGPT You can connect Payhawk from the ChatGPT plugin directory, also on the Free plan: 1. Open [Payhawk’s listing in the ChatGPT plugin directory](https://chatgpt.com/plugins/plugin_asdk_app_6ae9cebd8a24819181e0d5f882c42eb9). 2. Follow the prompts to install Payhawk and connect your account. 3. Sign in with the credentials you use for the [Payhawk Web Portal](http://portal.payhawk.com/) and approve the connection. Once connected, you can ask ChatGPT about your Payhawk data and take actions within your Payhawk permissions. You can also add Payhawk in the ChatGPT desktop app with the Payhawk MCP server URL: 1. In the ChatGPT desktop app, go to **Settings** > **Plugins** > **Add** > **Add MCP server**. 2. Enter a name, for example **Payhawk**. 3. Choose **Streamable HTTP** and paste the Payhawk MCP server URL [https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp). 4. Sign in with your Payhawk credentials when prompted. ## Connecting to Codex The Codex desktop app is now part of the ChatGPT desktop app. To use Payhawk there, follow the steps for ChatGPT. To connect Payhawk to the Codex CLI (the command-line tool): 1. In a terminal, run `codex mcp add payhawk --url https://mcp.payhawk.com/mcp`. 2. Run `codex mcp login payhawk`. 3. Sign in with your Payhawk credentials in the browser window that opens. UI components, such as flight or approval widgets, don’t render in Codex. You get the answer as text. ## Connecting to Cursor To connect Payhawk to Cursor: 1. In Cursor, go to **Customize** > **MCPs** > **New MCP Server**. Cursor opens your `mcp.json` file. 2. Add Payhawk inside `"mcpServers"`, as in the following example. If the file already lists other servers, add a comma after the previous entry. ```plaintext {  "mcpServers": {    "payhawk": { "url": "https://mcp.payhawk.com/mcp" }  } } ``` 3. Save the file and go back to **Customize** > **MCPs**. 4. Under **Needs Attention**, click **Authenticate** next to Payhawk and sign in with your Payhawk credentials. Payhawk now appears under **Connected**. ## Connecting to the GitHub Copilot app To connect Payhawk to the GitHub Copilot app: 1. In the GitHub Copilot app, go to **Customize** > **Installed**. 2. Next to **MCP Servers**, click **Add server** > **Add custom server**. 3. In **Server name**, enter a name, for example **payhawk**. 4. In **Server type**, choose **HTTP**. 5. In **URL**, paste the Payhawk MCP server URL [https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp). 6. Leave **Headers**, **OAuth Client ID**, and **Timeout** empty, and click **Add server**. 7. Sign in with your Payhawk credentials when prompted. ## Connecting to GitHub Copilot in VS Code To connect Payhawk to GitHub Copilot in VS Code: 1. In VS Code, open the Command Palette (`Cmd+Shift+P` on Mac, `Ctrl+Shift+P` on Windows) and run **MCP: Add Server**. 2. Choose **HTTP**. 3. Paste the Payhawk MCP server URL [https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp). 4. Enter a name, for example **Payhawk Customer MCP**. 5. Choose **Global** or **Workspace**. VS Code adds Payhawk to your `mcp-config.json` file, as in the following example: ```plaintext {  "mcpServers": {    "Payhawk Customer MCP": {      "type": "http",      "url": "https://mcp.payhawk.com/mcp",      "tools": ["*"]    }  } } ``` ## Connecting to Microsoft Copilot Studio To connect Payhawk to Microsoft Copilot Studio: 1. In Copilot Studio, go to **Tools** and click **New tool**. 2. Select **Model Context Protocol**. 3. Fill in the required fields: a name in **Server name**, for example **Payhawk MCP**, a description in **Server description**, and the Payhawk MCP server URL [https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp) in **Server URL**. 4. In **Authentication**, choose **OAuth 2.0**, and in **Type**, choose **Dynamic discovery**. 5. Click **Create**. Payhawk now appears in your list of tools. ## Connecting to Microsoft 365 Copilot Microsoft 365 Copilot has no option to add a connector. Instead, you package Payhawk as an agent in VS Code and publish it to your organization. ### What you need To publish Payhawk to Microsoft 365 Copilot, you need: - A Microsoft 365 work account. Personal Microsoft accounts don’t work. - A Microsoft 365 Global Administrator or Teams Administrator for the approval steps. - Visual Studio Code with the **Microsoft 365 Agents Toolkit** extension, version 6.12.0 or later. ### Allowing custom apps (once, by an administrator) In the [Teams admin center](https://admin.teams.microsoft.com): 1. Go to **Teams apps** > **Setup policies** > **Global (Org-wide default)**, turn on **Upload custom apps**, and click **Save**. 2. Go to **Teams apps** > **Manage apps** > **Actions** > **Org-wide app settings**, turn on **Let users interact with custom apps in preview**, and click **Save**. The changes can take up to 24 hours to apply. ### Creating the agent in VS Code To create the Payhawk agent: 1. In VS Code, click the **Microsoft 365 Agents Toolkit** icon in the left bar. 2. Click **Create a New Agent/App** > **Declarative Agent** > **Add an Action** > **Start with an MCP Server**. 3. For the server URL, enter [https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp). 4. For the authentication, select **OAuth (with dynamic registration)**. 5. Choose a folder for the project and name the agent, for example **Payhawk**. 6. In the new VS Code window, click **Trust**. If you missed the prompt, click **Restricted Mode** in the status bar, and then click **Trust**. ### Setting the name and description Set a real name and description for the agent. If you skip this step, users see placeholder text and a “dev” suffix on the name. 1. In `appPackage/manifest.json`, replace the placeholder values of `developer.name`, `name.full`, `description.short`, and `description.full`. 2. In `appPackage/declarativeAgent.json`, replace `description`. 3. Create the file `env/.env.prod` with the following content: ```plaintext TEAMSFX_ENV=prod APP_NAME_SUFFIX= ``` ### Publishing the agent To send the agent to your administrator for approval: 1. In the **Lifecycle** pane, click **Provision** and choose **prod**. 2. Click **Publish** and choose **prod**. ### Approving the agent (by an administrator) In the [Microsoft 365 admin center](https://admin.microsoft.com): 1. Go to **Agents** > **All agents** > **Requests**. 2. Open the Payhawk agent and click **Publish to store**. 3. Under **Select users or groups who can install the agent**, choose **All users** or specific groups. You can also choose who gets the agent pre-installed in their sidebar. 4. Accept the default security policy, review the permissions, and click **Publish**. If the security policy step keeps loading, approve the agent in the Teams admin center instead: go to **Teams apps** > **Manage apps**, find the Payhawk agent, and publish or allow it. Users then open Payhawk under **Agents** in the Copilot sidebar. The first time they ask something, they click **Sign in**, sign in with their Payhawk credentials, and approve the access. ## Connecting to Langdock To connect Payhawk to Langdock: 1. In Langdock, go to **Integrations** > **Create** > **Integration**. 2. Select **Connect remote MCP**. 3. In **Server URL**, paste the Payhawk MCP server URL [https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp). 4. In **Authentication method**, choose **OAuth 2.0 (Dynamic Client Registration)**. 5. Sign in with your Payhawk credentials when prompted. ## Connecting to Notion To connect Payhawk to Notion: 1. In Notion, go to **Settings** > **Connections**. 2. Click **+ Add connection** > **Custom MCP connection**. 3. In **MCP server URL**, enter the Payhawk MCP server URL [https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp), and in **Name**, enter a name, for example **Payhawk**. 4. In **Authentication**, choose **OAuth**. 5. Click **Connect**. Notion shows a notice that it hasn’t reviewed this server, which is expected for custom servers. 6. When Notion takes you to Payhawk, sign in with your Payhawk credentials. ## Connecting to Dust To connect Payhawk to Dust: 1. In Dust, go to **Spaces** > **Tools** and click **Add tools**. 2. Click **Add MCP server**. 3. In **URL**, paste the Payhawk MCP server URL [https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp). 4. Leave **Authentication** set to **Automatic** and click **Save**. Payhawk now appears in your list of tools. ## After you connect Payhawk to your AI Assistant Once you are connected, you can ask about expenses, invoices, card transactions, suppliers, and budgets, and you can also ask your AI Assistant to take actions, such as recoding expenses, approving items, freezing cards, and creating requests. Every change shows a preview first and waits for your explicit confirmation. For more hands-on information, see the article about [getting the best out of the Payhawk MCP](/help/payhawk-mcp-questions-and-actions).