How do I install the homespunapps/homespun MCP server?

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "homespun": { "command": "npx", "args": ["-y", "homespunapps/homespun"] } }

Is the homespunapps/homespun MCP server free to use?

Yes. homespunapps/homespun is listed on AllMCPs as a free, open Model Context Protocol server you can install into Claude Desktop, Cursor, or any MCP-compatible client.

HomespunDeveloper Tools

homespunapps

Hosts multi-user web apps created by an AI agent with realtime DB, role permissions, and magic-link sign-in.

Overview

This MCP server enables an AI agent to deploy and operate live multi-user web applications from a single HTML file and manifest. It hosts apps at unique URLs with features like magic-link authentication, shared realtime databases, per-role permissions, email notifications, and file uploads. The agent retains ongoing read/write access to modify the app's data after deployment. Use this when you want an AI to build, host, and manage interactive web apps without manual deployment steps.

Use cases

•Deploy web apps from AI-generated HTML and manifest files

•Enable multi-user access with role-based permissions

•Provide realtime shared database functionality

•Send email notifications triggered by app events

•Allow file uploads within hosted apps

Key features

•Single-call deployment returning live app URL

•Magic-link sign-in authentication

•Shared realtime database for app data

•Per-role access control and permissions

•Email notification support

•File upload handling

Quick Install

Automated & IDE Setup

Copy the AI prompt to automatically install this server into your coding agent (Claude Code, Cursor, etc.), or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Install Config Generator

claude_desktop_config.json

{
  "mcpServers": {
    "homespunapps-homespun": {
      "command": "npx",
      "args": [
        "-y",
        "https://docs.homespun.dev)**"
      ]
    }
  }
}

💡 Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

Capabilities & Tool Schemas

Inspect callable tools, capabilities, and parameters exposed to AI agents by Homespun.

Extracted Tool Capabilities

Single-call deployment returning live app URL

Magic-link sign-in authentication

Shared realtime database for app data

Per-role access control and permissions

Email notification support

File upload handling

Documentation Overview

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

Terminal

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.

Related MCP Servers

View all alternatives

Frequently Asked Questions about Homespun

What is the Homespun MCP server used for?

Deploy and operate multi-user web apps from an agent: one call returns a live app on its own URL with magic-link sign-in, a shared realtime database, per-role permissions, email notifications and file uploads, and the agent keeps read and write access to the app's data afterwards to keep changing it. Remote https://homespun.dev/mcp or npx -y @homespunapps/mcp.

How do I install Homespun in Claude Desktop or Cursor?

Copy the client configuration JSON snippet from the installation section above into your claude_desktop_config.json or .cursor/mcp.json file, then restart your AI application.

Is the Homespun MCP server free and safe to use?

Yes, Homespun is listed as a free Model Context Protocol server. Always review repository source code and permissions before granting local workspace access to AI agents.

Technical Specs & Signals

TransportSSE (Remote)

RuntimeNode.js

Health CheckActive

CategoryDeveloper Tools

Installs0

GitHub stars1

44Quality signal: Fair · 44/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools24/30

Adoption1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Featured

AllMCPs Server

The official MCP server for AllMCPs.com — submit and manage tools directly from your AI.

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to get the verified badge and attach your website.

Free dofollow backlink: after claiming, verify your product site and place a dofollow AllMCPs badge — we recheck it stays live.

Claim & get free dofollow

Promote this listing

Optional paid placement. Free listings stay free forever.

Featured boost7 days in the spotlight · from $12/wk

Weeks

→ Runs until Aug 14, 2026

Category sponsorTop-of-category sponsorship · from $18/wk