> For the complete documentation index, see [llms.txt](https://docs.mosofin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mosofin.com/source-and-destination/destinations/grok/connect-grok.md).

# Connect MosoFin to Grok

Add MosoFin as a custom Grok connector, authorize your account, and confirm that Grok can see the correct workspaces.

## Choose your setup path

| Account type                  | Who sets it up?                                  | Start here                                           |
| ----------------------------- | ------------------------------------------------ | ---------------------------------------------------- |
| Individual account            | You                                              | [grok.com/connectors](https://grok.com/connectors)   |
| Business or Enterprise member | Your team admin provisions MosoFin first         | Ask your admin to complete [team setup](#team-setup) |
| Business or Enterprise admin  | You provision MosoFin, then connect your account | [Team setup](#team-setup)                            |

## Before you begin

You need:

* A MosoFin account with at least one active workspace.
* QuickBooks connected to the workspace you want to use.
* Permission to add connectors in Grok, or help from your team admin.
* The MosoFin MCP server URL: `https://mcp.mosofin.com/mcp`.

## Step 1: Add MosoFin

1. Go to [grok.com/connectors](https://grok.com/connectors) and sign in.
2. Select **New Connector**.
3. Select **Custom**.
4. Name the connector **MosoFin**.
5. Enter `https://mcp.mosofin.com/mcp` as the MCP server URL.
6. Continue, then sign in to MosoFin.
7. Review and approve the connection.
8. Return to Grok and confirm that MosoFin appears in the connected list.

**1. Open the Grok connector picker**

<img src="https://469337450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGbnTb0p4vvSwwMyEuJgG%2Fuploads%2Fgit-blob-237aecd4954ccb26738053ba7e79c53886c0c7c0%2Fgrok-connectors-page.png?alt=media" alt="Open the connectors page in Grok and select a custom connector" width="735">

**2. Enter the MosoFin MCP server**

<img src="https://469337450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGbnTb0p4vvSwwMyEuJgG%2Fuploads%2Fgit-blob-7c1d68d3b93dd7d9d99b81c68749425008ada8fa%2Fgrok-custom-connector.png?alt=media" alt="Add the MosoFin MCP server as a custom Grok connector" width="640">

**3. Sign in to MosoFin**

<img src="https://469337450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGbnTb0p4vvSwwMyEuJgG%2Fuploads%2Fgit-blob-f80e27e2acb9a59b0ab05fc52d5ab13e047cd274%2Fgrok-mosofin-sign-in.png?alt=media" alt="Sign in to MosoFin from the Grok authorization window" width="560">

**4. Authorize Grok access**

<img src="https://469337450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGbnTb0p4vvSwwMyEuJgG%2Fuploads%2Fgit-blob-b436f56bdab4d1051d4489abdfed829b655a28e5%2Fgrok-mosofin-authorization.png?alt=media" alt="Authorize Grok to use MosoFin with the selected workspace" width="560">

**5. Confirm the connector was added**

<img src="https://469337450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGbnTb0p4vvSwwMyEuJgG%2Fuploads%2Fgit-blob-7aba0ba0ad633e53e29a391d8eebf7d4e1b5819e%2Fgrok-connector-added.png?alt=media" alt="MosoFin appears in Grok as an added connector" width="735">

## Step 2: Test the connection

Start a new Grok conversation and enter:

`List my MosoFin workspaces.`

Review and approve the tool request if Grok asks. The response should list only the workspaces your MosoFin account can access.

**6. Confirm Grok can reach your MosoFin workspace**

<img src="https://469337450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGbnTb0p4vvSwwMyEuJgG%2Fuploads%2Fgit-blob-1fd36c8339d7c8e15baaf3e267fc82874c87d3ec%2Fgrok-list-mosofin-workspaces.png?alt=media" alt="Test the MosoFin connection by listing workspaces in Grok" width="735">

## Try your first question

`Using [workspace name], summarize revenue and expenses for last month.`

## Team setup

Grok Business and Enterprise require a team admin to provision the connector.

1. Sign in to the [xAI Console](https://console.x.ai/).
2. Select the correct team.
3. Open **Grok Business** → **Connectors**.
4. Select **+ Add Connector** → **Other**.
5. Enter **MosoFin** and `https://mcp.mosofin.com/mcp`.
6. Complete MosoFin authorization.
7. Ask each member to connect their MosoFin account at [grok.com/connectors](https://grok.com/connectors) and run the test prompt.

Team connector provisioning may look different depending on the Grok plan and admin console version. Use the same server URL, `https://mcp.mosofin.com/mcp`, when adding MosoFin for the team.

## Permissions and privacy

All MosoFin QuickBooks tools are read-only. They cannot create, update, or delete records or post transactions. Review every permission request before approving it.

## Disconnect or reconnect

Go to [grok.com/connectors](https://grok.com/connectors), find MosoFin, and choose **Disconnect** or **Remove** from its management menu. Repeat the setup steps to reconnect.

Next, see [how data appears in Grok](https://docs.mosofin.com/source-and-destination/destinations/grok/data-overview.md).
