Integrations
How Muin connects to QuickBooks, Stripe, and the tools you already use — what syncs, how often, and how to set up each integration in minutes.
25 questions
How do I connect cloud storage to Muin?
**Google Drive is the cloud storage provider you can connect today**: Dropbox, OneDrive and SharePoint are not yet available. To sync documents automatically: 1. Go to **Settings** --> **Integrations** 2. Find **Google Drive** 3. Click **Connect** and authorize Muin to access your account 4. Choose which folders to sync: Muin monitors these folders for new files 5. New files added to synced folders are automatically imported into Muin for processing You can configure sync direction (one-way or two-way), file type filters, and processing rules. For example, sync only PDF files from a specific "Invoices" folder and have Muin process them automatically. See the [Cloud Storage guide](/docs/platform/integrations/cloud-storage) for detailed setup instructions. For files in Dropbox or OneDrive today, use bulk upload or [email forwarding](/docs/platform/integrations/email-forwarding): neither needs a connection.
Can I sync Muin with QuickBooks?
Yes, with QuickBooks Online. **Xero is not yet available.** **What syncs:** invoices, bills, vendors and customers. You choose which on the QuickBooks screen's **Settings** tab, along with how often (every hour, daily or weekly) and whose data wins when a record differs. **To connect:** 1. Go to **Settings** → **Integrations** and click **Connect QuickBooks** under Accounting 2. Sign in to Intuit in the popup and approve access 3. Click **Settings** on the QuickBooks card, then set **Data Types to Sync** and **Automatic Sync** 4. Match vendors and customers on the **Vendors** and **Customers** tabs, and map accounts on **Accounts** 5. Click **Sync Now** on **Sync History** to run the first sync QuickBooks needs the Finance module. See [Syncing with QuickBooks](/docs/platform/integrations/quickbooks-sync) for every tab. Xero is not available yet; its [guide](/docs/platform/integrations/xero) previews how it will work.
Can I forward documents to Muin via email?
Yes. Every tenant has an auto-generated forwarding address at `<your-tenant-slug>@inbound.falaah.ai`. Forward any email to that address and Muin auto-imports the attachments into your document library, then runs auto-classification. See the [email forwarding setup guide](/docs/platform/integrations/email-forwarding) for Gmail, Outlook, and other providers.
Can I use my own custom domain (e.g. documents@my-org.example) for forwarding?
Yes, on Scale and Enterprise plans. Submit a request from **Settings** → **Email Forwarding** → **Request custom domain**. Our team provisions the SES Configuration Set, DNS records, and routing rules within 2 business days. Until then, the shared `<your-tenant-slug>@inbound.falaah.ai` address gives you the full forwarding flow with no setup needed.
How do I manage my connected apps and integrations?
Open **Connections** in the sidebar (owners and admins). The **My Integrations** tab lists every connection with its status, last sync, schedule and success rate. On each one you can: - **Sync Now** to run a sync immediately, on connections that import data (for example Google Drive or QuickBooks) - **Test Connection** to check Muin can still reach the service - **Configure** to change the sync schedule and settings - **Delete** to remove it and stop all of its syncs Click a connection to open its page, with **Overview**, **Runs**, **Settings**, **Audit** and **Debug** tabs. The **Sync History** and **Health Status** tabs on the main screen show every run and which connections need attention. Apps that connect **to** Muin, such as Claude, are listed separately at **Settings** → **Integrations** → **Connected apps**, where you can see when each was last used and any recent problems, and revoke its access.
Can my agents use tools from our own MCP server?
Yes. Go to **Settings** → **Integrations** → **MCP Connections**, open the outbound tab, and click **Add MCP Server**. Enter its URL and how it signs in, and Muin lists the tools it offers. Its tools stay off until you open the server and choose the feature a person must hold to use them: **view** to read, **edit** to change. Once permitted, they appear in custom agents, workflow tool steps and Ask Muin. Any change through an outside server waits in **Inbox** for a person to approve it, and Muin cannot undo it afterwards. See [Connecting Your Own MCP Servers](/docs/platform/integrations/mcp-servers).
Can I connect Claude or another AI assistant to my Muin data?
Yes. Muin runs a built-in MCP (Model Context Protocol) server, and connecting is a sign-in rather than a credential. 1. In Claude, open the Connectors page, choose **Add custom connector**, and paste `https://muin-api.falaah.ai/api/v1/mcp` 2. Choose **Connect**, sign in to Muin, and approve access. Claude sees only what your Muin role allows 3. Ask Claude about your organization, for example "Using Muin, what are my fund balances?" On Claude Code, or anywhere with no browser to sign in with, create an API key at **Settings** → **Integrations & Data** → **Integrations** → **API Keys** instead. See [Getting started with Muin in Claude](/docs/platform/integrations/claude-getting-started) for every path, and the [FAQ](/docs/platform/integrations/claude-faq) for permissions and disconnecting.
Can Claude start a purchase request or pay a vendor bill?
Claude can draft a purchase request, and it never pays a bill. Ask Claude something like "Start a purchase request for two laptops for the youth program." Claude prepares the draft with its lines and total, and the draft waits in your Muin **Inbox** under **Waiting for your approval**. Once you approve it there, it is saved as your draft. You then review it and submit it in Muin, where the budget and fund checks run and it goes to its approver. Drafting needs the purchase requests permission in your Muin role and a connection an owner or admin allowed to make changes. Paying, approving and submitting a purchase request always happen in Muin.
Is it safe to give an AI assistant access through MCP?
The MCP server is designed read-first and tenant-scoped: - **Most tools only read.** The few that can change your records, each marked in the MCP Tools Reference, need the connection to carry write access. A read-only connection cannot call any of them - **A change never runs on the assistant's say-so.** It comes back as a preview and waits in your Muin **Inbox**. It runs only when you approve it in Muin, on the web or in the Muin Go app. Approving inside the assistant, a token, or calling the tool again does not run it - The connection only reaches **your organization**, and it carries **your own permissions**: an assistant can never see or do more than the person who approved it - Disconnect at **Settings** --> **Integrations** --> **Connected apps** and access stops immediately. On the API-key path, delete the key at **Settings** --> **Integrations** --> **API Keys** - If Muin refuses a write, the fix depends on how you connected: on a sign-in connection it is your role or the approval, and there is no credential to rotate; on an API key it is the key's scope - Calls are rate-limited and you can tag each agent with an identifier for audit logs
What can an MCP-connected assistant actually do?
Tools across six areas, all but three read-only, limited to the Muin modules your organization has turned on. The three that change records (recording a contribution, advancing a workflow, starting an agent) wait for your approval in Muin before they run: - **Non-profit** - fundraising health, campaign progress, fund balances, donor stewardship, grant pipeline, Form 990 readiness, and recording a contribution (waits for your approval in Muin) - **Documents**: keyword search, retrieve extracted fields, list recent uploads - **Finance**: query invoices, get invoice detail, MTD/YTD spend summaries with overdue lists - **HR & Compliance**: compliance health score, expiring certifications, policy gaps - **Workflows** - pending tasks, instance status, template catalog, and advancing a workflow (waits for your approval in Muin) - **Grounding**: verified org profile, upcoming public events, semantic document search See the MCP Tools Reference for the complete table.
Where did Integrations go? I can't find the integration catalog.
Everything is on one screen now: **Connections** in the sidebar. The page is titled **Integrations** and has four tabs: **My Integrations**, **Integration Catalog**, **Sync History** and **Health Status**. Old bookmarks to `/integrations` and `/integrations/apps` open the same screen. If you do not see **Connections** in the sidebar, your role is not owner or admin; ask an owner to add the connection or give you the admin role.
Why does a catalog card say Managed in Settings, Upgrade to Connect or not available yet instead of Connect?
The button on each catalog card tells you whether you can connect that service today: - **Connect**: available now. - **Set Up** or **Managed in Settings**: available, but set up on its own screen. Slack is set up in **Settings** → **Integrations**, the custom REST API connector under **Settings** → **Integrations** → **API Connectors**, and Finch payroll under **HR** → **Payroll**. - **Not available yet**: not connectable yet (for example Xero, Dropbox, OneDrive, HubSpot). - **Upgrade to Connect**: the service belongs to a module your plan does not include, such as Finance for QuickBooks. - **Unavailable**: temporarily switched off.
I clicked Connect and the popup said Authorization Failed. What do I do?
Read the message under **Authorization Failed**, then: - **"Invalid or expired OAuth state"**: the popup was open too long or came from an old tab. Close it and click **Connect** again from **Connections** → **Integration Catalog**. - **access_denied** or a similar message from the service: you clicked cancel, or the account lacks permission there. Try again with an admin account for that service. - **Popup blocked**: allow popups for Muin, or paste the sign-in link Muin copied to your clipboard into a new tab. - **Authorization timed out**: you have 2 minutes to finish signing in. Start again and finish in one go. Nothing is connected until you see **Connected Successfully!**
An app is asking for access to my Muin organization. What happens if I click Allow access?
Muin's approval screen names the app, the organization, what it **Can read** and what it **Can change**. Nothing is shared until you click **Allow access**. If you allow it, the app gets only what you can already see, in that one organization, and never your password. If it asked to change things, only an owner or administrator can approve. Click **Not now** to refuse; nothing is shared. An **Unverified app** badge means the app registered itself. Only approve apps you started the connection from yourself. You can end access any time at **Settings** → **Integrations** → **Connected apps**.
How do I stop Claude or another app from reaching our data?
1. Go to **Settings** → **Integrations** → **Connected apps** 2. Find the app and click **Revoke access** 3. Confirm with **End access now** The app loses access immediately and any session it has open stops working. Each row also shows who authorized the app and when its access ends (90 days after approval unless the app reconnects). If the app used an API key instead, revoke the key at **Settings** → **Integrations** → **API Keys**.
A connection says Unhealthy or the circuit breaker opened. How do I get it syncing again?
Open **Connections**, click the connection, and click **Test Connection**. - If the test fails on sign-in or permissions, the service revoked Muin's access (often after a password change). Click **Disconnect**, then connect it again from **Integration Catalog**. - If the provider was failing or throttling, Muin pauses that connection to protect your account and retries on its own. Admins see **Reset Circuit Breaker** and **Reset Rate Limit** on the connection page. Reset only once the provider is working again: you get **one circuit-breaker reset per day** per connection. Admins also get an **Inbox** task when a connection turns Degraded or Unhealthy, and an email when it is Unhealthy.
Which events can a Muin webhook send to my server?
Twelve events deliver to webhooks today: `document.processed`; `invoice.created`, `invoice.approved`, `invoice.paid`; `calendar.event.published`, `calendar.event.unpublished`, `calendar.event.cancelled`, `event.capacity_full`; and `registration.created`, `registration.cancelled`, `registration.checked_in`, `registration.no_show`. The event picker at **Settings** → **Integrations** → **Webhooks** offers exactly these. Tick the ones you want rather than leaving the list empty. Every delivery is signed in the `X-Muin-Signature` header; see [Webhooks](/docs/api/webhooks) for verification code.
How do I rotate or revoke an API key without breaking my integration?
Open **Settings** → **Integrations** → **API Keys** and click the key. - **Rotate** issues a new key with the same name, scopes and expiration. **The old key stops working immediately**, so update your script with the new key at the same moment. - **Revoke** ends the key at once and cannot be undone. To switch with no gap, create a second key first, move your script to it, then revoke the old one.
How do I connect the Muin WordPress plugin?
1. In WordPress, install and activate the Muin plugin, then open **Settings → Muin**. 2. In Muin, open **Products** and the product you want. In **Connect your website**, press **Create a connect code**. 3. Paste the code into that product's **Connect code** field in WordPress and press **Connect**. 4. Add the product's block to a page: **Muin AI Help Desk**, **Muin Online Giving** or **Muin Facility Rentals**. Shortcodes work too: `[muin-support]`, `[muin-donate]`, `[muin-rental-request]`. A code works once and expires after 10 minutes.
The WordPress plugin says my connect code is not valid. What now?
Connect codes last 10 minutes and work once. Create a new one on the product's Product Home under **Connect your website** and paste it straight away.
Can I use the WordPress plugin for just one product?
Yes. Connect only the products you want, each with its own connect code. A product you have not connected shows nothing on your site, and disconnecting one leaves the others connected.
How do I remove Muin from a WordPress site?
Press **Disconnect** on the product's row in **Settings → Muin** in WordPress, or next to the site under **Connected websites** on the Product Home in Muin. The product stops showing on that site. Deleting the plugin disconnects every product and removes its settings. Your Muin account and data stay as they are.
How do I show the AI Help Desk chat bubble on every WordPress page?
Connect the AI Help Desk in **Settings → Muin**, tick **Show the chat bubble on every page**, and press **Save**. Without it, the bubble shows only on pages where you add the **Muin AI Help Desk** block.
Can I sign in with QuickBooks?
No. Signing in with an Intuit or QuickBooks account is not available. - Sign in with email, Google or Apple. - Then connect QuickBooks from your connectors so your books stay in sync.
What does Muin write back to Procore?
The Procore connector is planned and not available yet. This is how it works once it ships. **Nothing is written to Procore until you turn it on.** A new Procore connection only reads your Procore subcontractors into Muin, by job site. To let Muin write back, open the Procore connection under **Connectors**, go to the **Settings** tab and turn on **Write compliance back to Procore**. Write-back comes with the Subcontractor Management solution; with Vendor Compliance or Property Management alone, the connection only reads from Procore. With write-back on, Muin writes: - each vendor's compliance status, on the vendor and on its commitments; - vendors you added in Muin, to the Procore company and project directory; - insurance certificates that were reviewed in Muin; - vendor bill payments Muin recorded, on the vendor's commitment; - your vendor messages, as private correspondence items. This needs the Correspondence tool on your Procore plan. Muin uses its own "Muin Compliance" correspondence type unless you pick another under **Procore correspondence type** on the **Settings** tab. Some Procore plans only allow types added from a Procore template; add one in Procore under Company Admin > Tool Settings > Correspondence > Types, then pick it. Without the Correspondence tool, Procore refuses the messages and each one is listed as refused, with Procore's reason. Muin writes back when a sync runs, after the daily re-screen of vendors and after the daily chase. It never moves money in Procore and never writes bank details. **Where to see each write.** Open the connection and go to the **Runs** tab. Each write-back run is one row with its counts. Select **Details** on the row to see every write that was refused, with Procore's reason.
Other FAQ Categories
Didn't find your answer?
Our support team is happy to help with any questions.
Contact Support