Connect your AI to Homespun
Homespun is where your AI puts the things it builds for you: a grocery list the family can open, a habit tracker, a trip plan, each one a real app at its own link. Connecting takes about two minutes and you only do it once. Pick the AI you use.
In a coding agent
Anything with a terminal. Paste one prompt: it installs the Homespun CLI, gets you signed in, and then asks what you want to build.
homespun watch for live data.
Anything else
Any agent that can run a shell command, including ones that did not exist yet.
In a chat app
Nothing to install, and the only route that works on a phone. Paste one URL into the app's connector settings and sign in by email.
Troubleshooting the connection
Almost every failure is one of these seven, and none of them need support.
My chat app has no custom connector option
Not every chat client supports remote MCP connectors yet, and on some the feature depends on your plan. If yours has no such option, use a coding agent instead: Claude Code, Cursor, Windsurf and Cline all connect in a minute, and they build into the same Homespun account.
My agent says homespun: command not found
The CLI installed but its directory is not on this shell's PATH, which most often means npm's global bin is missing from it. Check with npm bin -g and add that directory to your PATH, or open a new terminal and try again. Node 20 or newer is required, so confirm node -v as well.
Nothing happens when I click Connect
The sign-in opens in a new window, so check that pop-ups are not blocked and try again. If it still does not open, confirm the relay is reachable by loading https://homespun.dev/healthz in a browser.
The consent screen says the client is not verified
That is expected. Homespun allows open client registration so that clients like the Claude mobile app can connect at all, which means no client can be pre-verified. Before you approve, check that the redirect host shown on the consent screen is the app you are actually authorizing.
The tools do not appear after I connect
Reopen the tools or connectors menu in your chat app. Some clients only pick up a newly added connector when a conversation is restarted, so start a fresh chat and look again.
Do I need a paid plan or an API key
No. Homespun is free to use, there is no API key to copy for the connector, and Claude supports custom connectors on its free plan. You sign in with your email address and that is the whole account setup.
How do I disconnect an AI from Homespun
Remove the connector in your chat app's settings. Its access is revoked immediately and your other connections, and any CLI key, are unaffected. Access tokens are short-lived and refresh automatically, and every token is revocable.
Still stuck? The connection guide on the docs site goes deeper, including how the OAuth flow works and what a connection is allowed to do.
What to build first
Once your AI is connected, the fastest start is to copy something that already works. The Homespun template gallery is full of apps other people made and shared: a chore rota, a reading list, an approval form. Ask your AI to install one and change it to suit you, or just describe what you want and let it build from scratch.
Arrived here from a Claude Artifact that could not do what you needed? The two walls people hit first are what a Claude Artifact can and cannot store and whether other people can use an artifact you built. The reference pages on Claude Artifacts limits cover sharing, unpublishing and databases too, and what changes when you move something to a hosted app.