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 分