Housekeep MCP example
About
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…
Details
- Author
- mrmikardo
- Downloads
- 175
- Categories
- Cloud Service
Jump to
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Housekeep MCP exampleCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"housekeep mcp example": {
"housekeep-mcp-netlify": {
"command": "npx",
"args": [
"@modelcontextprotocol/inspector",
"npx",
"mcp-remote@next",
"http://localhost:8888/mcp"
]
}
}
}
}McpServers
{
"housekeep-mcp-netlify": {
"command": "npx",
"args": [
"@modelcontextprotocol/inspector",
"npx",
"mcp-remote@next",
"http://localhost:8888/mcp"
]
}
}Housekeep MCP example
View the Housekeep MCP site: https://housekeep-mcp.netlify.app/
What is this?
This repo shows a very a basic example of developing and running serverless MCP using Netlify Functions. It includes links to a deployed serverless function and an example of accessing the function using a customized URL.
- Model Context Protocol (MCP)
- Docs: Netlify Functions
- Agent Experience (AX)
The MCP server provided here exposes three _tools_:
- get-trades-services-summary - returns a high-level summary of the trades services offered by Housekeep
- get-trades-quote - calls the Housekeep API /trades-quote/ endpoint to get a quote for a trades job
- create-booking-attempt - calls the Housekeep API to create a booking attempt for a trades job
> Note that at the time of writing, it's only possible to create plumber, gardener or handyman bookings using the create-booking-attempt tool.
Architecture
The MCP server is designed to be used with the Claude Desktop app (although it ought to work with other AI Clients, too). This diagram shows how the MCP server integrates with Claude Desktop.
Setting the MCP server up with Claude Desktop
To set up the MCP server with Claude Desktop, follow these steps:
1. Open the Claude Desktop app.
2. Open the settings, then click "Developer".
3. Click the "Edit Config" button. This will open the config file in a Finder window (on macOS).
4. Open the config file in a text editor and paste in the config below. Save the file and restart Claude Desktop.
{
"mcpServers": {
"housekeep-mcp": {
"command": "npx",
"args": ["mcp-remote@next", "https://housekeep-mcp.netlify.app/mcp"]
}
}
}
Development
Clone this repo to explore and run it locally.
```shell
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
