00Widget MCP server
2026년 11월 9일 커밋AI agent 및 애플리케이션이 iOS 위젯, Live Activities, Dynamic Island, Apple TV 대시보드에 구조화된 상태를 게시할 수 있도록 지원합니다.
다른 이름 morais/00widget
- 스타
- 1
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 1.0.0
- 마지막 커밋
- 2026년 11월 9일
- 라이선스
- —
00Widget MCP란?
AI agent 및 애플리케이션이 iOS 위젯, Live Activities, Dynamic Island, Apple TV 대시보드에 구조화된 상태를 게시할 수 있도록 지원합니다.
프로젝트 README에서 생성된 요약
00Widget MCP server 정보
00Widget은 AI agent와 소프트웨어 애플리케이션이 Apple 기기에 구조화된 정보를 표시할 수 있는 방법을 제공합니다. 이 시스템은 디지털 프로세스와 iOS 위젯, Live Activities, Dynamic Island, Apple TV 대시보드와 같은 네이티브 인터페이스 사이의 가교 역할을 합니다. 복잡한 UI 코드를 전송하는 대신, 사용자의 기기에서 사전 정의된 SwiftUI 템플릿을 통해 렌더링되는 구조화된 상태를 전송합니다.
개발자는 Claude 또는 ChatGPT와 같은 호스트에서 특정 URL을 커스텀 커넥터로 추가하여 Model Context Protocol을 통해 연결할 수 있습니다. 커스텀 스크립트, CI 파이프라인 또는 홈 자동화의 경우, upsert 또는 batch updates와 같은 엔드포인트를 통해 데이터를 게시할 수 있는 REST API를 제공합니다. 백엔드는 Cloudflare Worker로 구축되었으며, 인증된 액세스를 위해 API key 또는 테넌트 토큰이 필요합니다. 사용자는 Apple ID로 로그인하는 웹 기반 관리 대시보드를 통해 데이터와 자격 증명을 관리할 수 있습니다.
활용 사례
- 1실시간 빌드 상태 표시AI agent가 소프트웨어 빌드의 현재 상태를 iOS 위젯에 게시할 수 있습니다.
- 2시간 민감 프로세스 모니터링개발자가 Live Activities를 사용하여 배송이나 충전 사이클과 같이 종료 시간이 명확한 작업을 추적할 수 있습니다.
- 3Apple TV에서 agent 출력 관리사용자는 Apple TV 대시보드에서 진행 중인 활동과 카운트다운을 확인할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
00Widget MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 00Widget MCP 설치
$ claude mcp add --transport http 00widget https://api.00widget.com/mcpCursor에 00Widget MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"00widget": {
"url": "https://api.00widget.com/mcp"
}
}
}VS Code에 00Widget MCP 설치
.vscode/mcp.json
{
"servers": {
"00widget": {
"type": "http",
"url": "https://api.00widget.com/mcp"
}
}
}VS Code CLI에 00Widget MCP 설치
$ code --add-mcp '{"name":"00widget","type":"http","url":"https://api.00widget.com/mcp"}'Codex에 00Widget MCP 설치
$ codex mcp add 00widget --url https://api.00widget.com/mcpCodex config.toml에 00Widget MCP 설치
~/.codex/config.toml
[mcp_servers.00widget] url = "https://api.00widget.com/mcp"
Gemini CLI에 00Widget MCP 설치
$ gemini mcp add -s user --transport http 00widget https://api.00widget.com/mcpGemini settings.json에 00Widget MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"00widget": {
"url": "https://api.00widget.com/mcp",
"type": "http"
}
}
}자동 검사
2026년 11월 15일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능morais/00widget is public and reachablegithub.com/morais/00widget ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)No license결함 발견
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-09github.com/morais/00widget ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답HTTPS endpoint answered 401 (sign-in required)통과
README
GitHub에서 보기00Widget
Widgets for all your agents.
A reusable Apple-platform companion app and Cloudflare Worker backend that gives Claude, ChatGPT, automations, and software you build a native output channel through widgets, Live Activities, the Dynamic Island, and Apple TV dashboards.
The server never sends UI — only structured state conforming to a small set of templates. The Apple apps render that state through predefined SwiftUI views.
Choose how to connect
Claude, ChatGPT, and other MCP hosts
Hosts that speak the Model Context Protocol can publish to 00Widget with no
integration code: add <BASE_URL>/mcp as a custom connector, sign in, and pick
a tenant. The tools wrap the same handlers as the REST routes, so the two
surfaces cannot drift.
MCP is off by default (MCP_ENABLED in wrangler.toml) because it exposes a
browser flow that mints API tokens on the public internet. Approving a connector
requires signing in, and the credential it issues is a normal tenant token
scoped to the approver's own account, revocable from /admin.
Details: server/README.md → "MCP".
An additive MCP Apps UI can be tested without touching that connector: deploy
the same Worker with MCP_PREVIEW_ENABLED = "true", then add
<BASE_URL>/mcp-preview as a separate Developer Mode connection. It adds
read-only render_card, render_activity, and render_dashboard tools backed
by a versioned HTML resource; /mcp keeps its existing discovery and tool
contract.
Apps, scripts, automations, and coding agents
If you're inside another repo (say, a CI pipeline or a home-automation script) and want to make Claude Code / Codex publish state to your 00Widget instance, paste this into the agent — it's self-contained:
Integrate this project with 00Widget so its state shows up on iOS widgets and Live Activities.
Read the integration contract: https://github.com/morais/00widget/blob/main/docs/llms.md
That single document is everything you need — don't pull in the rest of the 00Widget repo.
Operator-supplied env vars:
00WIDGET_BASE_URL=https://api.example.com
00WIDGET_API_KEY=<bearer token>
Verify both work with `curl $00WIDGET_BASE_URL/health` and an authenticated `GET /v1/cards` before writing any code.
Then:
1. Identify the surfaces in this project that an iOS widget should reflect (status, build state, queue depth, in-progress jobs, etc.).
2. For each, pick a template (`summary`, `progress`, `list`, `action`, `chart`, `history`, `breakdown`, `briefing`, or `timeline`) per llms.md's decision matrix.
3. Add the smallest possible publish path — POST one card to `/v1/cards/upsert`, or one related snapshot to `/v1/cards/upsert-batch`, using stable ids. No SDK, no class hierarchy.
4. If something is time-bounded with a clear end (a build, a charge cycle, a delivery), use a Live Activity instead of a card.
Constraints:
- Use a stable `id` per logical thing — never embed timestamps or run ids.
- Never put secrets or PII in card fields. They render on the Lock Screen.
- Always end Live Activities. Never make destructive actions auto-run from widgets.
- Don't publish more than ~once a minute per card unless the value actually changed.
If this project is itself a Cloudflare Worker, see the "Notes for Cloudflare Workers callers" section in llms.md — same-account integrations should use a Service Binding instead of a public HTTPS fetch.
Anatomy
00widget/
ios/ # SwiftUI app + WidgetKit extension + Live Activity (iOS 26+)
server/ # Cloudflare Worker (TypeScript) — REST API + APNs fan-out
examples/ # curl scripts showing how any agent can publish state
marketing/ # Screenshot and App Preview sources, docs, and entry points
artifacts/ # Generated marketing output (ignored by Git)
Quick start
1. Backend
cd server
npm install
install -m 600 .dev.vars.example .dev.vars # fill in SESSION_SECRET; enable the local fallback only when needed
npx wrangler dev
Then:
curl -s http://localhost:8787/health
2. Examples
cd examples
install -m 600 env.example.sh env.sh # edit BASE_URL and API_KEY
./upsert-solar.sh
3. iOS
Requires macOS with Xcode 26+, iOS 26 simulator or device, and XcodeGen.
brew install xcodegen
cd ios
xcodegen
open ZeroZeroWidget.xcodeproj
In Xcode, change the bundle id and App Group to values your Apple Developer team owns (see ios/README.md), then run.
Data model
See ios/Sources/Shared/Models/ (Swift) and server/src/types.ts (zod) — the two are kept in lockstep.
- DashboardCard — a single widget tile. Templates:
summary,progress,list,action,chart,history,breakdown,briefing,timeline. - LiveActivitySession — a Lock Screen / Dynamic Island activity.
- ActionDefinition — a button that runs a backend-defined action via
POST /v1/actions/:id/run.
Web sign-in and admin
/login signs a person in with the same Apple ID they use in the iOS app.
Signing in establishes identity, not authority: ADMIN_EMAILS names the
addresses whose sessions additionally carry admin capabilities, and every route
under /admin asserts that capability rather than assuming it.
Signing in does not sign you up. The callback resolves the Apple identity
against the account the app created and turns away one it does not recognise, so
finding this endpoint is not a way to become a tenant. WEB_SIGNUP_ENABLED
(off by default) opts a deployment into web account creation.
The admin dashboard at /admin lists cards, devices, push tokens, Live
Activities, pending activities, and push-to-start tokens across every tenant. It
can also create and revoke tenant credentials and delete tenant data, so access
grants full administrative control rather than read-only visibility. An
API_KEYS bootstrap login (ADMIN_API_TOKEN_LOGIN=true, off by default) covers
a deployment that has no accounts yet.
Administration is enabled by default. Set ADMIN_ENABLED = "false" under
[vars] in server/wrangler.toml and redeploy to make /admin and all its
mutation endpoints return 404 before session or database access. Web sign-in,
the account dashboard, MCP authorization, and the public API remain available.
Create least-privilege tenant API tokens from /admin using the tenant owner email and a permission preset; those generated credentials are what apps and agents use for /v1/*.
Setup walkthrough: server/README.md → "Web sign-in".
Documentation
ios/README.md— Xcode setup, entitlements, signing.server/README.md— Worker deploy, D1 binding, APNs secrets, web sign-in and admin.examples/README.md— publishing state from any shell or agent.docs/llms.md— for agents (Claude Code / Codex) integrating another project with 00Widget.docs/brand/README.md— logo, colors, tagline rules.marketing/screenshots/README.md— raw capture, promotional composition, and App Store screenshot workflow.marketing/app-preview/README.md— App Store Preview capture, rendering, and validation workflow.
Status
Working end-to-end. Cards publish, Live Activities start/update/end, push-to-start is wired, and APNs payloads are verified against Apple's current docs (date-stamped in server/src/apns.ts).
Push-to-start (ActivityKit, iOS 17.2+) — fully implemented. iOS observes Activity<ZeroZeroWidgetActivityAttributes>.pushToStartTokenUpdates from didFinishLaunchingWithOptions, registers via POST /v1/live-activities/register-start-token. The backend's POST /v1/live-activities/start sends the start event to all registered devices and falls back to the pending-queue path if no token is registered (or if the APNs delivery fails). End-to-end verification needs .p8 credentials configured on the Worker.
tvOS activity dashboard — the Apple TV app lists ongoing Live Activities above its widgets. The backend exposes one deduplicated tenant-scoped view across pending starts and registered device activities, while tvOS renders countdowns and progress locally.
WidgetKit pushHandler (iOS 26+) — fully implemented. Each widget configuration calls .pushHandler(ZeroZeroWidgetPushHandler.self). The handler persists WidgetKit’s canonical token/configuration snapshot in the App Group, and the host app reconciles it at launch, on foreground, after app-build changes, and through a short bounded retry while WidgetKit finishes generating a token. Backend pushes carry aps.content-changed: true, use budget-aware per-tenant cadence, and durably coalesce suppressed changes into one delayed queue delivery when the cadence window opens. A successful foreground app fetch also requests targeted timeline reloads immediately. End-to-end verification still needs .p8 credentials and a physical device.
License
Source code is MIT licensed. The 00Widget name and brand assets are excluded; see LICENSE and docs/brand/LICENSE.
00Widget MCP 질문
00Widget MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --transport http 00widget https://api.00widget.com/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
00Widget MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
Claude 또는 ChatGPT를 00Widget에 어떻게 연결하나요?
MCP 호환 호스트에 /mcp가 포함된 기본 URL을 커스텀 커넥터로 추가하고, 로그인한 뒤 테넌트를 선택하여 연결할 수 있습니다.
위젯에 어떤 종류의 데이터를 보낼 수 있나요?
서버는 summary, progress, list, action, chart, history, breakdown, briefing, timeline과 같은 템플릿을 따르는 구조화된 상태를 전송합니다.
위젯에 민감한 정보를 넣어도 안전한가요?
아니요, 위젯 카드는 잠금 화면에 표시되므로 비밀번호나 개인정보(PII)를 카드 필드에 포함해서는 안 됩니다.
개인 스크립트나 자동화 도구와 함께 사용할 수 있나요?
네, bearer token을 사용하여 /v1/cards/upsert와 같은 엔드포인트로 POST 요청을 보내는 REST API를 통해 상태를 게시할 수 있습니다.