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 your AI below.
Connect Claude on web, desktop, or your phone
This is the shortest way in, and the only one that works on a phone: nothing to install, no terminal, no API key. Claude supports custom connectors on the web, desktop and mobile apps, on the free plan as well as the paid ones. You do it once and every Claude surface signed in to the same account picks it up.
-
Open Claude's connector settings
In Claude, open Settings and then Connectors. On the web that is claude.ai/settings/connectors; on mobile it is your profile, then Settings, then Connectors.
Open Claude's Connectors settings, then choose Add custom connector.
-
Paste the Homespun connector URL
Name the connector Homespun and paste https://homespun.dev/mcp as its URL, then save.
https://homespun.dev/mcp -
Sign in and approve
Click Connect. A Homespun window opens: sign in with your email using the magic link, then approve the consent screen. Claude shows the connector as Connected.
-
Ask for the app you want
Start a chat and describe the app in your own words. Claude builds it, hosts it on Homespun, and hands you back a link you can open on any device.
Try it with something small: "Use Homespun to build us a grocery list the whole family can open, and give me the link." If you would rather start from something that already exists, browse the Homespun template gallery and ask Claude to install one for you.
The connector is bound to your Homespun account, so the apps you build from your laptop are the same apps you see from your phone. Remove it from Claude's connector settings at any time and its access is revoked immediately, without touching any other client you have connected.
Connect Claude Code from the terminal
Claude Code speaks remote MCP natively, so it can use the hosted connector with nothing running locally. One command registers it, one browser round trip authorizes it, and the Homespun tools are available in every session after that.
-
Register the connector
Run the mcp add command in your project directory. It registers Homespun as an HTTP transport MCP server named homespun.
claude mcp add --transport http homespun https://homespun.dev/mcp -
Authenticate
Run /mcp inside Claude Code, select homespun, and choose Authenticate. Your browser opens on the Homespun sign-in and consent screen, and the token is stored for you.
/mcp -
Build something
Ask Claude Code for the app you want. It creates the app, deploys it to Homespun, and returns the URL, then keeps operating it as the data comes in.
Prefer streaming and local control? The Homespun CLI gives you homespun watch and the full command surface. The remote connector and the CLI are interchangeable, so pick whichever suits the machine you are on, or use both.
Connect ChatGPT and other chat apps
Homespun's connector is a standard OAuth-protected Streamable HTTP MCP endpoint, not a Claude-specific integration, so any chat app that supports remote MCP connectors can use it. In ChatGPT the feature appears wherever custom connectors or MCP servers are configured, which varies by plan and by client version.
-
Find the connector settings
Open the ChatGPT settings screen that lists connectors or MCP servers, and choose the option to add a new one.
-
Add the Homespun server URL
Give it the name Homespun and the server URL https://homespun.dev/mcp. There is no API key and no client secret to configure: the client registers itself.
https://homespun.dev/mcp -
Complete the sign-in
Approve the OAuth prompt when it appears. Sign in to Homespun with your email magic link, then approve the consent screen, and the connector reports itself as connected.
-
Ask for an app
Describe what you want in the chat. ChatGPT calls the Homespun tools, and you get back a link to a real hosted app you can open and share.
Not sure what to ask for? The template gallery is a good list of things people actually build.
If your version of ChatGPT has no custom-connector option yet, nothing is lost: use a coding agent instead. Claude Code and Cursor both connect in under a minute, and the apps you build land in the same account.
Connect Cursor, Windsurf, Copilot, and Cline
Cursor, Windsurf, Cline and VS Code Copilot all configure MCP servers from a JSON file, and they all accept the same entry. Add the block below to your MCP configuration, reload the editor, and approve the sign-in when the client opens it.
-
Open your MCP configuration
In Cursor, open Settings and then MCP, and edit the servers JSON. Windsurf, Cline and VS Code Copilot each have an equivalent MCP servers file.
-
Add the Homespun server
Add an entry named homespun with type http and the hosted Homespun URL, then save the file.
{ "mcpServers": { "homespun": { "type": "http", "url": "https://homespun.dev/mcp" } } } -
Reload and authorize
Reload the editor so it picks up the new server. The client opens the Homespun sign-in the first time it calls the connector: sign in by email and approve the consent screen.
-
Build and deploy
Ask your editor's agent for the app you want. It deploys to Homespun and gives you back a shareable link, then keeps working on the app as you use it.
Any other client works the same way. Wherever an app asks for a remote or HTTP MCP server URL, give it https://homespun.dev/mcp: it advertises its own OAuth metadata, so the client discovers the sign-in flow by itself.
Install the Homespun CLI
The CLI is the option for people who would rather run things themselves: it deploys from a directory, streams live events with homespun watch, and gives any coding agent the full command surface without an MCP connector at all. It needs Node 20 or newer.
In a hurry? Paste this one line into Claude Code, Cursor, Codex, or any other coding agent and it sets itself up, no steps below required:
Set me up with Homespun: read https://homespun.dev/skills/homespun/SKILL.md and follow it, then ask me what app I want to build.
-
Install the CLI
Install it globally with npm. The binary is called homespun.
npm i -g @homespunapps/cli -
Sign in
Register an agent. This opens a browser for the device-authorization sign-in and writes the resulting key to your Homespun config, so you only do it once per machine.
homespun agent register --name home -
Teach your agent the CLI
Point your coding agent at the Homespun skill. It documents every command and stays current on its own.
homespun skill show
Connecting over MCP instead? Then you can skip the skill: the connection describes its own tools to the model. Full command reference on the Homespun docs site.
Troubleshooting the connection
Almost every failure is one of these six, 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.
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.