ManaWG

com.manawg由 manawg.com 發布官方發布者v0.2.1更新於 Nov 4, 2026

Shared-flat app ManaWG: expenses, cleaning rota, shopping list, calendar and chat for agents.

已驗證Streamable HTTP可網頁執行效率與工作流金融溝通與協作

概覽

AI 產生的概覽

ManaWG 讓助理連結共用公寓應用程式：費用、餘額、打掃輪值表、購物清單、佈告欄、聊天與行事曆。

可以做什麼
  • 檢視公寓總覽、儀表板、動態與匯出資料
  • 建立與編輯費用及固定支出、記錄現金付款、預覽結算方案
  • 管理購物清單、庫存用品與打掃輪值，包括外出請假
  • 張貼佈告與留言，傳送與讀取聊天訊息
  • 列出、建立與更新行事曆事件
  • 使用每日簡報、採買、繳款提醒與結算規劃等內建提示
適用情境
適合使用 ManaWG 的共居住戶，想讓助理回答本週有哪些待辦、記錄剛付的費用、把東西加進購物清單、調整打掃輪值，或算出誰欠誰。
執行需求
使用 mcp.manawg.com 的遠端 streamable HTTP 端點，免安裝、免 API 金鑰。需透過瀏覽器以 OAuth 登入 ManaWG 帳號，且該帳號至少屬於一個共居公寓。也可自行架設，需 Node.js 22 與 pnpm，或使用 Docker，並設定自己的執行個體憑證。
安裝前請注意
助理會以你的帳號身分、依你在所有公寓中的權限行動，可建立與編輯費用、輪值、佈告、聊天訊息與事件。託管伺服器省略了 16 個破壞性工具（刪除項目、變更設定、寄送提醒、提交匯入），但寫入仍會改動共享資料。它從不轉移金錢，結算只是記錄彼此已付的款項。可在設定的存取頁面查看已連結的助理，並中斷不再需要的連線。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 ManaWG，將其新增到工作區。
  2. 連接 所需的 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/com.manawg%2Fmcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。

{
  "mcpServers": {
    "manawg": {
      "type": "http",
      "url": "https://mcp.manawg.com/mcp"
    }
  }
}

README

ManaWG MCP

Your shared flat, for your AI assistant: expenses, balances, cleaning rota, shopping list, supplies, noticeboard, chat and calendar of ManaWG, as tools for Claude, ChatGPT, Cursor and every other MCP client.

Connect an agent · Tools · Self-host · How it works · Contribute

[CI] [Latest release] [MCP Registry: com.manawg/mcp] [Container image on GHCR] [License: Apache-2.0]

ManaWG is the free, open-source app for shared flats (WG, from the German Wohngemeinschaft). This server lets an assistant work with your flat the way you do in the app: it reads what is due, books what you just paid, puts milk on the list, and tells you who owes whom.

Connect an agent

Use the hosted server at https://mcp.manawg.com/mcp. Your client opens the browser, you sign in to ManaWG and allow the assistant. There is no key to copy and nothing to install.

ClientHow to add it
Claude Codeclaude mcp add --transport http manawg https://mcp.manawg.com/mcp
Claude (web, desktop)Settings → Connectors → Add custom connector, URL https://mcp.manawg.com/mcp
ChatGPTSettings → Apps & Connectors → Advanced settings → Developer mode, then Create with the URL and OAuth
Cursor, VS Code, othersAdd a streamable HTTP server with the URL https://mcp.manawg.com/mcp

No ManaWG account yet? Create one and a flat at app.manawg.com, or let the assistant call wg_create once you are signed in.

Things to ask

  • "What is due in the flat this week?"
  • "I paid 42.80 € for groceries, split it between everyone except Jonas."
  • "Who owes whom, and what is the smallest number of payments to settle up?"
  • "Put oat milk and dish soap on the shopping list."
  • "I'm away from the 12th to the 19th, take me off the cleaning rota."
  • "Write a friendly reminder for the open balances, but don't send it."

What the assistant can do

The assistant acts as your account, in all your flats, with the same rights you have in the app.

  • It can read everything you can see, create and edit expenses, fixed costs, shopping items, supplies, chores, posts, chat messages, events and absences, and settle debts the way the app does.
  • It cannot delete a flat, change your account or sign-in, or move money. ManaWG never moves money; settling up only records what you paid each other.
  • The hosted server leaves out all 16 destructive tools: deleting expenses, posts or items, changing flat or member settings, sending reminders and committing imports. Read tools carry readOnlyHint, so clients can ask before every other call.
  • You stay in control. Every assistant you connected is listed in the app under Settings → Access, and you can disconnect each one there.

The full list of 74 tools, 13 resources and 4 prompts is in docs/tools.md.

AreaExamples
Overviewwg_overview, dashboard_get, activity_get, export_get
Moneyexpense_create, balances_get, settlement_preview, cash_payment_record
Fixed costsrecurring_list, recurring_create, recurring_advance
Shopping and suppliesshopping_add, shopping_set_bought, inventory_consume
Cleaning rotachores_list, chore_complete, absence_create
Noticeboard and chatnote_create, note_comment, chat_send, chat_unread
Calendarevents_list, event_create, event_update
Promptsdaily_brief, shopping_run, payment_reminder, settlement_plan

How it works

mermaid
sequenceDiagram    autonumber    participant C as MCP client    participant M as mcp.manawg.com    participant S as Supabase Auth    participant A as app.manawg.com    C->>M: POST /mcp    M-->>C: 401 + protected resource metadata    C->>S: register client, start sign-in (PKCE)    S->>A: consent page    A-->>S: user signs in and allows    S-->>C: access token    C->>M: POST /mcp with bearer token    M->>M: verify token against the JWKS    M->>A: same call to the app API, with the token    A-->>M: data, checked against your membership    M-->>C: tool result

The server is an OAuth 2.1 resource server as the MCP authorization spec describes it. Supabase Auth, which already runs the app's sign-in, is the authorization server. The MCP server stores nothing: it checks each token and forwards it, and the app applies the same membership checks as for your phone.

Each tool calls exactly one route of the app API. Money is in integer cents, every write carries an idempotency key so a retried request is never booked twice, and writes that could race with a flatmate fail instead of overwriting (chore_occurrence_changed, shopping_item_changed). Errors come back as a fixed code such as ManaWG request failed: splits_sum_mismatch, never with upstream text or credentials.

Self-host

Run it on your own machine for a local agent over stdio, behind an API key over HTTP, or as your own OAuth server in front of your own ManaWG instance.

bash
git clone https://github.com/Abuarchiv/manawg-mcp.git && cd manawg-mcppnpm install && pnpm buildmkdir -p ~/.config/manawg-mcp && cp .env.example ~/.config/manawg-mcp/envchmod 600 ~/.config/manawg-mcp/env        # then fill in your instance and accountclaude mcp add manawg --env-file ~/.config/manawg-mcp/env -- node "$(pwd)/dist/index.js"

Or with Docker: ghcr.io/abuarchiv/manawg-mcp (linux/amd64, linux/arm64).

The self-hosting guide covers both auth modes, every environment variable, the HTTP transport, Docker and the Vercel deployment behind mcp.manawg.com.

Develop

You need Node.js 22 and pnpm 9. Tests, lint and typecheck need no credentials.

bash
pnpm lint        # Biomepnpm typecheck   # tsc --noEmitpnpm test        # Vitest: flows against a stateful stub app, API surface, OAuthpnpm build       # compile to dist/pnpm smoke       # stdio handshake against dist/pnpm inspector   # MCP Inspector against dist/index.jspnpm live-check  # read-only probes against a real instance (credentials required)

The tests run the real server, client and session code against a stub of the app that enforces its rules (Origin, cookies, idempotency keys, optimistic locking, strict bodies), and an API surface check keeps every tool mapped to a route the app actually has.

Contributing

Issues and pull requests are welcome. Read CONTRIBUTING.md and the Code of Conduct first. Problems with the app itself belong in the app repository. Report security problems privately, see SECURITY.md. Changes are listed in CHANGELOG.md.

License

Apache License 2.0, like the ManaWG app. The licence does not grant rights to the name ManaWG or its logo.

來源：README.md，提交 e70cb66

工具

0
該伺服器需要登入，因此 SourceWeft 無法在沒有帳號的情況下讀取其工具，也未收錄。已連接帳號所能看到的內容可能因帳號及其權限而異。

版本歷史

1
  1. v0.2.1最新Nov 4, 2026

評分

已滿足適用檢查項的 85%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分