GymSpotter OS · Settings & Integrations
Integrations
Every API and MCP connection GymSpotter OS uses, for the business you are in, with its status. QuickBooks, Google Sheets and Grasshopper are set up in this browser; the Reports connections are kept by the Reports engine; the Communications connections (Twilio, Voiceflow, Bland AI, HubSpot forms and email, mailboxes) are kept by the Communications engine. Both store keys on this computer, outside the business folder, and only ever show their last four characters. Open it from the Integrations button in the top bar, Settings → Integrations, or the sidebar under Settings.
Interactive demo with fictional businesses and sample records. Edits stay in your browser. Live synchronization, messaging and AI require a connected private workspace.
What this workspace covers
Integrations button in the top bar
On every page. The button opens this page and shows how many connections are connected. Its arrow lists each connection with its status (Connected, Files only, Not set up, Unavailable) and has Open Integrations, MCP servers and Settings.
Business and Refresh status
Business shows which business you are setting up; choosing another reloads the app as that business. Refresh status checks every connection again.
Summary tiles
Connected, Using file imports, Not set up and MCP servers. Click a tile to jump down the page.
Engine and Reports notices
If the Reports engine is not running, a notice says so and has Try again; QuickBooks, Sheets and Grasshopper still work. A business without Reports gets a Set up Reports button.
Category links
Jump to Business systems, Communications, Leads & calls, Advertising, Website & SEO, Google account, MCP servers or Reports data folder.
QuickBooks Online
The QB bridge URL and password, the Intuit app's client ID, secret, realm ID and redirect URI, Sandbox or Production, Test & Connect Bridge, Save QB Settings, and switches to sync invoices and purchase orders (as bills).
Google Sheets (inventory sync)
OAuth client ID, spreadsheet ID and range, Sign in with Google, Sign Out and Enable write-back. Only Google accounts from the Workspace domain on Company & Brand Kit may sign in.
Grasshopper Bridge
Open Grasshopper Platform, the bridge webhook URL and access password, Connect Bridge and Save Endpoint URL. The bridge sends a signal when a dispatch order is placed and reads an order's status.
HubSpot CRM and GymSpotter OS operations
HubSpot's private-app token turns closed-won deals into sales in Reports. The operations card imports sales, expenses, invoices, purchase orders and inventory exports for the report's profit pages.
Communications: texts, calls, chats, forms and email
Twilio for texts and the call log with recordings (your company numbers, sender, incoming-text webhook and Allow sending texts from GymSpotter OS; Save numbers, Connect Twilio, Sync texts, Sync call log), Voiceflow web chat, the Bland AI phone agent and HubSpot website forms (Connect & sync, Sync now), the HubSpot marketing email library (Save & refresh the library, Refresh now, and Forget the token once a token is saved), mailboxes (Connect Gmail, Connect Outlook, Import MBOX / EML) and Google Analytics website visits (Import). The Twilio, Voiceflow, Bland AI and HubSpot forms cards show Disconnect once connected or saved, a connected mailbox shows Disconnect Gmail or Disconnect Outlook, every card has a Guide, and Keep connected after a restart keeps the Twilio, Voiceflow, Bland AI and HubSpot keys on this computer.
Communications folder
Where this business's calls, texts, chats, forms, email and contacts are kept (<business>\Communications), with their counts, Show the yearly archives and a Guide. A business that has none gets Set up Communications.
Leads & calls
800.com: API token, company ID and the tracking numbers, for calls and texts. Website forms (Gmail): the Gmail search and mailbox that hold the form emails; it uses the Google sign-in.
Advertising
Google Ads: customer ID, manager (MCC) ID and API version; it uses the Google sign-in. Meta Ads: system-user token, app ID and secret, API version and the ad account ID.
Website & SEO
Google Analytics 4 property ID and Search Console property (both use the Google sign-in), and Ahrefs API key, target, mode and country.
Google account
One sign-in covers Google Ads, Analytics, Search Console, Gmail and Sheets. Add the OAuth client ID and secret, tick the products to allow, and click Sign in with Google.
What each card holds
Status, what it is used by, the months of data it has, what an API pull still needs, credentials (for every company or this one only), account IDs, and how each kind of data arrives: API, file imports, MCP or typed by hand.
Card buttons and Test
Save stores the card. Test makes one read-only call and says if the token works. Import exports and Pull data open Reports → Import & sync, Guide shows the connector's notes, and MCP jumps to its server.
MCP servers for AI agents
Tick the servers to offer Claude Code and click Save .mcp.json; the table shows what each one needs. Copy buttons give the add command, the command that loads the saved tokens and starts Claude, and the Claude Desktop config.
Reports data folder
Where this business's files and Reports data are, which businesses have Reports, the credentials folder and whether the Reports engine is running, with Open Reports.
Settings drawer: Integrations
The Settings button in the top bar opens the drawer. Its Integrations tab lists every connection's status, opens this page, and holds the Grasshopper, Google Sheets and QuickBooks forms on other pages.
Settings: Folder
Connect GymSpotter OS Folder, Use this app's own folder, Unmount Folder, Data Sources with Review loaded data, a daily session log option, and Install App.
Settings: Columns
Show or hide Inventory table columns, with Show All and Reset Defaults. Use it on the Inventory page.
Settings: Theme
Switch between light and dark. The choice applies to every business.
Settings: Webhooks
The Grasshopper signal rules and a live event log with Clear and Simulate Event. The log and its buttons work on the Dashboard page.
Settings: Activity Log
Actions since this page opened, with your name, filter and type list, Export JSON, Save to Sessions/ and Clear.
Settings: Support
Help & Documentation and Keyboard Shortcuts.
AI settings
In the AI panel, the key button: save an API key for OpenAI, Anthropic, Google Gemini, xAI Grok or a local model, test it, load its models, and pick a model for chat, quick replies and document reading.
Set up texting and calls with Twilio
- Open the Twilio · texts & calls card in Communications.
- Type your Twilio phone numbers (one per line, +1…). They fill the Send texts from list.
- Paste the Account SID and Auth Token, choose Send texts from and click Connect Twilio. It saves the numbers too.
- Click Sync texts and Sync call log to bring in the history since 2023.
- To send texts later, register the number for US texting (A2P 10DLC), tick Allow sending texts from GymSpotter OS and click Update connection.
- If Keep connected after a restart was ticked, leave the Auth Token empty; otherwise paste it again first.
Connect Google once for ads, forms and analytics
- Open Integrations and go to Google account.
- Paste the OAuth client ID and client secret, then click Save.
- Leave every product ticked and click Sign in with Google.
- Finish signing in in the browser tab that opens.
- Click Test on the Google Ads, Website forms, GA4 or Search Console card.
Add a Meta Ads token
- Go to Advertising → Meta Ads.
- Under Save credentials for, choose every company or this business only.
- Paste the system-user access token and the Meta ad account ID.
- Click Save, then Test.
Connect QuickBooks Online
- Go to Business systems → QuickBooks Online.
- Enter the QB bridge webhook URL and access password.
- Fill in the Intuit app details and choose Sandbox or Production.
- Click Test & Connect Bridge.
Let Claude Code use GymSpotter OS
- Go to MCP servers and tick GymSpotter OS (this app) and any others you want.
- Click Save .mcp.json.
- Click Copy “load credentials + start Claude”.
- Open PowerShell in the GymSpotter OS folder and paste the command.
Set up Reports for a new business
- Switch to the business.
- Open Integrations.
- Click Set up Reports in the notice at the top.
- Fill in the account IDs on each card and click Save.
Practical tips
- Connected means the settings an API pull needs are saved. Use Test to prove the token works.
- Saved secrets show only their last four characters. Type a new value to replace one; the trash button removes it (Disconnect or Forget the token on a Communications card).
- Credentials saved for every company are shared by all businesses; account IDs always belong to one business.
- Bridge passwords for QuickBooks and Grasshopper are kept only until the app window or tab is closed.
- One Twilio account covers both texts and calls: the SMS & Text page shows the conversations and the Phone page shows the call log with recordings. Nothing is ever sent without a person pressing Send now.