GodOS

Model Context Protocol

Connect the assistant
you already use.

GodOS is a native MCP server. Point Claude, ChatGPT or any MCP client at the address and it works with your clients, projects, tracked time and invoices directly — under permissions you approve, one at a time.

Server address
https://godos.ch/api/mcp
Tools
92
Permissions
8
Setup
None

No API keys. OAuth discovery and client registration are automatic — the address is the whole configuration.

Connecting

Claude

  1. Open Settings → Connectors on web, desktop or mobile.
  2. Choose Add custom connector and paste the address.
  3. Sign in, review the permissions and approve.

Claude's voice mode reaches connected tools.

ChatGPT

  1. Turn on Developer mode. Plus, Pro, Business, Enterprise and Edu; on a workspace plan an admin enables it.
  2. Add a custom connector and paste the address.
  3. Sign in, review the permissions and approve.

Text chat only — ChatGPT voice cannot reach connectors yet.

Anything else

No manual setup. The server publishes OAuth discovery documents and registers clients dynamically, so any compliant client connects with just the address.

Protocol versions 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26.

Permissions

92 tools sit behind 8 permissions, grouped by what they risk rather than by feature. You approve each on the consent screen, and an assistant never learns a tool exists unless you granted its permission — so a read-only connection cannot try to delete something and explain the refusal afterwards.

PermissionWhat it allowsTools
Read your workspacegodos:readClients, projects, deals, invoices, hours, goals and finance.30
Log work and update recordsgodos:writeLog time, manage to-dos and goals, create and edit records.16
Create and change invoicesgodos:moneyDraft and edit invoices, mark paid, set rates, record payouts.7
Send things on your behalfgodos:sendEmail, invoices to other workspaces, invites, portal access.5
Manage settings and automationgodos:adminBusiness profiles, portal visibility, scheduled tasks, Operator.10
Delete recordsgodos:deletePermanently delete clients, projects, deals, invoices, to-dos.9
Drive your open GodOS tabgodos:screenOpen pages and run on-screen actions in a GodOS tab you have open.5
Read your HomeOS planner, calendar and filesgodos:homeRead-only: boards, personal calendar, and one cloud file at a time.10
TotalGranted individually, revocable at any time92

What it cannot do quietly

Anything that cannot be undone — deleting a record, sending an email or an invoice, inviting someone, recording a payout — never runs on the assistant's first attempt. The server refuses it and returns a one-line summary instead. The assistant has to read that back to you, and only a second call carrying a token the server issued will go through. That token is single-use and tied to the exact record, so a “yes” to one thing cannot be spent on another.

Everything else runs under your own account. An assistant sees exactly what you would see in the app: same workspace, same role, same hidden columns. It cannot reach another workspace, and a teammate's connector cannot reach past their own permissions.

Disconnecting takes effect within fifteen minutes, in Settings → Integrations, where every connected assistant is listed with the permissions it holds and when it was last used.

Driving the app itself

Grant godos:screen with GodOSopen in a browser and the assistant can move around it — open a client, jump to overdue invoices, run an action the current page offers. It can also read which page that is, so “start the timer on this” resolves to whatever is in front of you. With no tab open it is told so plainly rather than failing.

Your planner, calendar and files

Grant godos:homeand the assistant can also read HomeOS — the planner boards on your channels, your personal calendar, and your cloud spaces. That is what lets “what is on my plate this week” answer from the whole picture instead of half of it: dated planner cards and calendar events come back together, in your own timezone and working hours.

Files work deliberately differently. Three of the tools return only names, sizes and dates — enough to find what you meant. Reading contents is a separate tool that takes one space and one path, so the assistant pulls the single file you asked about and nothing else. Handing a model an entire drive to answer a question about one document is both useless and a disclosure, so it is not something this connector can do.

Everything under this permission is read-only. There is no tool here that creates, edits, moves or deletes anything in HomeOS, and access follows your own membership — a space or calendar that is not shared with you is invisible here exactly as it is in the app.

If it will not connect

Nothing happens after signing in
The address must be reachable over HTTPS from the internet. A local address only your own machine can resolve will not work.
It connects but finds no tools
No permissions were approved. Remove the connector, add it again, and approve at least “Read your workspace”.
It says it is not allowed to do something
That permission was not granted. Reconnect and approve it — the message names which one is missing.
Client accounts cannot connect
Portal logins have no workspace tools. Sign in with a workspace account.

Model Context Protocol is an open standard; connecting GodOS does not require any particular AI provider.