Housekeep MCP example

What is Housekeep MCP example?

It is a basic example of a serverless Model Context Protocol (MCP) server built with Netlify Functions. It exposes three tools to access Housekeep trade services—plumber, gardener, and handyman—and is designed primarily for use with the Claude Desktop app but also works with other AI clients.

How to use Housekeep MCP example?

Configure the server in Claude Desktop by adding a JSON block to its config file using npx mcp-remote@next and the deployed URL https://housekeep-mcp.netlify.app/mcp. For local development, clone the repo, install Netlify CLI, run netlify dev, and use the MCP inspector with npx mcp-remote@next http://localhost:8888/mcp.

Key features of Housekeep MCP example

• Serverless MCP server deployed on Netlify
• Exposes three tools for Housekeep trade services
• get-trades-services-summary returns a high-level summary
• get-trades-quote fetches a quote via the Housekeep API
• create-booking-attempt creates a booking for plumber, gardener, or handyman
• Works with Claude Desktop and other AI clients

Use cases of Housekeep MCP example

• Get a summary of trades services offered by Housekeep
• Request a quote for a specific trades job
• Create a booking attempt for a plumber, gardener, or handyman
• Integrate Housekeep booking functionality into an AI assistant
• Learn how to build and test serverless MCP servers locally

FAQ from Housekeep MCP example

What tools does the Housekeep MCP example provide?

It provides three tools: get-trades-services-summary, get-trades-quote, and create-booking-attempt.

How do I set up the server with Claude Desktop?

Open Claude Desktop settings → Developer → Edit Config. Paste the JSON configuration with "command": "npx" and "args": ["mcp-remote@next", "https://housekeep-mcp.netlify.app/mcp"], save, and restart the app.

Can I use other AI clients besides Claude Desktop?

Yes, the server ought to work with other AI clients, though it is designed with Claude Desktop as the primary client.

What bookings can be created using create-booking-attempt?

At the time of writing, only plumber, gardener, or handyman bookings can be created with this tool.

What are the dependencies for running the server locally?

You need Node.js, the Netlify CLI (netlify-cli), and npx. The repo also uses mcp-remote@next via npx for remote MCP connectivity.