How do I install Homespun?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Homespun need an API key?

The publisher lists these environment variables: HOMESPUN_API_KEY, HOMESPUN_URL, HOMESPUN_AGENT_NAME, HOMESPUN_REGISTER_SECRET.

Homespun

by dev.homespun

Deploy a multi-user web app from your agent: hosting, auth, database, and permissions.

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Server URL

https://homespun.dev/mcp

Credentials from the publisher

HOMESPUN_API_KEY — Homespun agent API key. If unset, the server auto-registers a fresh agent against the relay on first use and saves the key to the shared CLI store (~/.config/homespun/config.json).
HOMESPUN_URL — Homespun relay base URL. Defaults to the hosted relay https://homespun.dev; set this to point at a different relay.
HOMESPUN_AGENT_NAME — Display name for the auto-registered agent on the relay.
HOMESPUN_REGISTER_SECRET — Registration secret, required only for relays running REGISTRATION_MODE=secret.

Provider

Add in Claude

Claude opens with the name and URL filled in. You still confirm it there.

Claude Code

claude mcp add --transport http dev.homespun-homespun https://homespun.dev/mcp

Run in a terminal.

Claude Desktop

{
  "mcpServers": {
    "dev.homespun-homespun": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://homespun.dev/mcp"
      ]
    }
  }
}

claude_desktop_config.json

Step-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Related MCP

Related skills

View all

Questions

How do I install Homespun?: Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
Does Homespun need an API key?: The publisher lists these environment variables: HOMESPUN_API_KEY, HOMESPUN_URL, HOMESPUN_AGENT_NAME, HOMESPUN_REGISTER_SECRET.
What transport does Homespun use?: Homespun is reached over HTTP.
When was Homespun last checked?: Last checked 2026-10-16. Deploy a multi-user web app from your agent: hosting, auth, database, and permissions.

Homespun

Apps your AI builds and hosts, for you and the people you invite.

An agent creates a real web app from a single HTML file plus a manifest, and Homespun hosts it at a URL. People open the link and use it. No install, no build step, no deploy pipeline.

Docs: docs.homespun.dev

What is in this repository

The client side, all MIT licensed:

Package	What it is
`@homespunapps/cli`	The `homespun` command line client
`@homespunapps/mcp`	The MCP server, so an agent can drive Homespun as a tool
`@homespunapps/core`	Shared client library and types

Plus the agent skill (skills/homespun) and the Claude plugin (plugins/homespun).

The relay, which is the hosted server these clients talk to, is not open source and is not in this repository.

Getting started

npm install -g @homespunapps/cli
homespun agent register
homespun deploy ./my-app

./my-app needs an index.html and a manifest.json. The quickstart walks through both.

To use Homespun from a chat client such as Claude or ChatGPT instead of a terminal, see Connect to your AI chat, which needs no install at all.

Reference

Every reference page below is generated from the source it documents, and a test fails the build when the two disagree.

HTTP API, every /v1 endpoint
CLI, every command and flag
SDK, the window.homespun browser API
Manifest, the app manifest format
Errors, every error code
Agent guide and MCP guide

Contributing

This repository is a read-only mirror. See CONTRIBUTING.md.

License

MIT. See LICENSE.

Homespun

by dev.homespun

Deploy a multi-user web app from your agent: hosting, auth, database, and permissions.

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Server URL

https://homespun.dev/mcp

Credentials from the publisher

HOMESPUN_API_KEY — Homespun agent API key. If unset, the server auto-registers a fresh agent against the relay on first use and saves the key to the shared CLI store (~/.config/homespun/config.json).
HOMESPUN_URL — Homespun relay base URL. Defaults to the hosted relay https://homespun.dev; set this to point at a different relay.
HOMESPUN_AGENT_NAME — Display name for the auto-registered agent on the relay.
HOMESPUN_REGISTER_SECRET — Registration secret, required only for relays running REGISTRATION_MODE=secret.

Provider

Add in Claude

Claude opens with the name and URL filled in. You still confirm it there.

Claude Code

claude mcp add --transport http dev.homespun-homespun https://homespun.dev/mcp

Run in a terminal.

Claude Desktop

{
  "mcpServers": {
    "dev.homespun-homespun": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://homespun.dev/mcp"
      ]
    }
  }
}

claude_desktop_config.json

Step-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Related MCP

Related skills

View all

Questions

How do I install Homespun?: Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
Does Homespun need an API key?: The publisher lists these environment variables: HOMESPUN_API_KEY, HOMESPUN_URL, HOMESPUN_AGENT_NAME, HOMESPUN_REGISTER_SECRET.
What transport does Homespun use?: Homespun is reached over HTTP.
When was Homespun last checked?: Last checked 2026-10-16. Deploy a multi-user web app from your agent: hosting, auth, database, and permissions.

Homespun

Apps your AI builds and hosts, for you and the people you invite.

An agent creates a real web app from a single HTML file plus a manifest, and Homespun hosts it at a URL. People open the link and use it. No install, no build step, no deploy pipeline.

Docs: docs.homespun.dev

What is in this repository

The client side, all MIT licensed:

Package	What it is
`@homespunapps/cli`	The `homespun` command line client
`@homespunapps/mcp`	The MCP server, so an agent can drive Homespun as a tool
`@homespunapps/core`	Shared client library and types

Plus the agent skill (skills/homespun) and the Claude plugin (plugins/homespun).

The relay, which is the hosted server these clients talk to, is not open source and is not in this repository.

Getting started

npm install -g @homespunapps/cli
homespun agent register
homespun deploy ./my-app

./my-app needs an index.html and a manifest.json. The quickstart walks through both.

To use Homespun from a chat client such as Claude or ChatGPT instead of a terminal, see Connect to your AI chat, which needs no install at all.

Reference

Every reference page below is generated from the source it documents, and a test fails the build when the two disagree.

HTTP API, every /v1 endpoint
CLI, every command and flag
SDK, the window.homespun browser API
Manifest, the app manifest format
Errors, every error code
Agent guide and MCP guide

Contributing

This repository is a read-only mirror. See CONTRIBUTING.md.

License

MIT. See LICENSE.