shipwithmuse

№ 0223Skill

Muse connector starter on Cloudflare Workers

A Cloudflare Worker starter for Muse connectors that keeps upstream API keys server-side behind one bearer token, with an OpenAPI spec, SKILL.md template and proof checklist.

Muse connector starter on Cloudflare Workers on github.com
layermakerlab/muse-connector-starterREADME ↗
# Muse connector starter

A small Cloudflare Worker that sits between Meta's Muse and the API you want Muse to use. Most APIs don't need one:
if yours takes a single key, Muse connects to it directly. Use this when the API needs more than one secret (Muse holds
one key) or you're adding your own logic. It gets you to one real call through Muse in about an hour.

Not affiliated with Meta.

## What you get

- **A Worker facade** (`worker/index.js`): Muse sends one bearer token; the Worker checks it and calls your upstream
  API with the real key, which stays in the Worker's environment and never reaches Muse or a chat.
- **One working call**, `GET /v1/status`, that proves the bearer and the upstream key both work.
- **`openapi.yaml`**: that call described with bearer auth, ready to grow into your real API.
- **`CONNECT.md`**: a connect spec template (provider, hosts, auth scheme, where each key lives).
- **`SKILL.md`**: a skill template that teaches Muse when and how to call you, including confirming writes first.
- **`PROOF-CHECKLIST.md`**: what to show in a short video that proves the connector works end to end.

## Hour one

```bash
cd worker
npm install
npx wrangler login                          # free Cloudflare account; Workers free tier needs no card
# edit wrangler.toml: [vars] UPSTREAM_BASE_URL = your provider's API base URL
npx wrangler secret put UPSTREAM_API_KEY    # your provider's real key; the Worker holds it
npx wrangler secret put BEARER_TOKEN        # make one up: openssl rand -hex 32
npx wrangler deploy                         # prints your Worker URL
node --test test.mjs                        # the Worker's own checks
```

Then tell Muse: connect to your Worker URL, authenticate with `Authorization: Bearer <token>`, and call
`GET /v1/status`. If it comes back `ok: true` with the upstream reachable, the wiring is done. A 401 means the bearer
is wrong; an unreachable upstream means `UPSTREAM_BASE_URL` or `UPSTREAM_API_KEY` is wrong.

## The rules the Worker is built around

- One bearer for Muse. If the upstream needs several secrets, the Worker holds all of them.
- A long random bearer (at least 32 characters; the Worker refuses shorter). Add a Cloudflare rate-limiting rule on
  the Worker's route so nobody can hammer it or your upstream quota.
- Secrets only through `wrangler secret put`. Never in the repo, a prompt, or a chat.
- Any endp

Also filed under Connectors & MCP

See all →
  1. 0842

    Muse in iMessage via BlueBubbles★

    https://github.com/mvrius/bluebubbles-muse BlueBubbles server on my Mac, Muse hook polling it every ~5s. How it works: the poll driver (bash shim + Python filter) checks for new messages and filters on an allowlist of senders, 1:1 chats, and group GUIDs. A new message from an allowlisted sender wakes Muse into a side chat with the message as context. Replies go back out as normal iMessages through the Mac. Why this instead of a messaging connector: connectors need an approval tap on every send, otherwise similar could be acheived via Messenger connector. Setup: BlueBubbles on the Mac, Tailscale so the agent VM can reach it, run the installer. Repo has the hook scripts, installer, architecture doc, and skill definition. Known issues: I am noticing that sometimes Tailscale connection drops on the Mac. I found that I need to bring down/up tailscale every hour for connection to stay up. A fun example from earlier today, I updated my calendar, moved dinner with my wife by 30 minutes - Muse mesaged the Family chat and informed my wife of the change. Cool findings: - Muse has a Tailscale option, you can connect the VM it runs on in Client model with other machines running Tailscal

    u/Gold-Entry9142

    Reddit post

    Connectors & MCP

  2. 0707

    Todo-app sync built without an official API★

    Still really enjoying @muse. I use Things.app for all of my todos, and though it has cloud sync they (still) haven’t added an official API. I told muse to build it and a minute or two later I have ongoing todo sync from my LLM across all my Apple devices. Wild.

    @holman

    X post

    Connectors & MCP

  3. 0161

    Muse connector platform portal★

    Meta's developer portal for Muse connectors: describe a connector, submit it for functional, security and legal review plus end-to-end testing, and get listed in the Muse directory.

    muse.ai

    Site

    Connectors & MCP

  4. 0152

    Muse Connectors: 150 one-paste skills★

    An open-source collection of 150 auditable connector skills for Muse that install with one pasted prompt, declare their allowed hosts and keep credentials in the user's Muse vault.

    @bluman1

    Skill

    Connectors & MCP

More Skills

See all →
  1. 1073

    Xahau skill for Muse

    Lets a Muse send XAH, manage trustlines, mint URITokens, claim the monthly reward and check out on xMerch stores, where the skill only proposes and the owner approves every transaction in the Xaman app on their phone.

    @terramike

    Skill

    Business & commerce

  2. 1068

    musebook: shared family boards for Muses

    An open protocol plus Muse skill and Cloudflare Workers reference server that lets each family member's Muse join shared boards (groceries, trips, household lists) with per-board identities and an approval card before anything is ordered.

    @amanbthakkar

    Skill

    Errands & personal agent

  3. 1062

    xrpl-muse-skill: let your Muse trade XRP

    A terminal skill for trading any XRP Ledger token pair and minting NFTs, with a hard boundary between proposing and signing; testnet by default, and mainnet needs the Muse vault signer or a protected signer with per-transaction approval.

    @terramike

    Skill

    Business & commerce

  4. 1052

    changelly-buy Muse skill

    A Muse skill that helps people buy crypto (XRP by default) with a card through Changelly, giving CoinGecko spot estimates, prefilled buy links and plain fee disclosure without any API keys.

    @terramike

    Skill

    Business & commerce

Curator picks

  1. 1046

    Medical bills audited line by line, $4,000 saved★

    Got Muse logged in to my medical provider’s portal, he pulled the itemized bills, and questioned every line. So far he’s found several times I’d been double billed, asked for some discounts and has saved me over $4,000. If your moat is bureaucracy, you’re cooked.

    @Ryan_Holdaway

    X post

    Errands & personal agent

  2. 1013

    Shop Pay agentic checkout on every Shopify store★

    We are excited to announce we are partnering deeply with Muse to enable agentic checkout with Shop Pay on all Shopify stores, offering people an easy and delightful way to shop and check out with Muse.

    @tobi

    X post

    Business & commerce

  3. 1009

    Private e-book library app from Google Drive★

    Muse built me a private library for the e-books and articles in my Google Drive. Everything is organized by topic, and each section opens onto its own subcategorized shelves. Each book opens like a real book and is readable in-app

    @chiasmus_cap

    X post

    Apps & websites

  4. 1007

    Plumbing company run by a Muse agent★

    I still can’t believe I can run my plumbing company with an agent so easily. I send this message to my Muse agent while in bed at 6am. And it: updates my job board, texts customer, updates office manager who arrives at 8am in slack Notifies technician

    @HouseHackerJon

    X post

    Agents & automation