Cleaning service management — book appointments, manage jobs, customer scheduling

by pampalini1

244 downloads Not rated yet

GitHub

About

MCP server for ShineByGrace, a domestic cleaning service in the UK. Book and manage cleaning appointments, assign cleaners to customers, track job schedules, and communicate with staff — all via AI tool use.

Explore

- 13 AI-callable tools split into customer and staff sets
- Customer tools: check slots, book, cancel, reschedule, message staff
- Staff tools: list/create/update/complete jobs, manage customers
- Bearer token authentication with scoped access
- Tokens prefixed sbg_cu_ (customer) or sbg_st_ (staff)
- Integrates with a live API at shinebygrace.co.uk

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 Cleaning service management — book appointments, manage jobs, customer scheduling

Command (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

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "cleaning service management \u2014 book appointments, manage jobs, customer scheduling": {
            "shinebygrace": {
                "url": "https://shinebygrace.co.uk/api/mcp",
                "headers": {
                    "Authorization": "Bearer sbg_st_YOUR_TOKEN"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cleaning service management \u2014 book appointments, manage jobs, customer scheduling": {
            "shinebygrace": {
                "url": "https://shinebygrace.co.uk/api/mcp",
                "headers": {
                    "Authorization": "Bearer sbg_st_YOUR_TOKEN"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cleaning service management \u2014 book appointments, manage jobs, customer scheduling": {
            "shinebygrace": {
                "url": "https://shinebygrace.co.uk/api/mcp",
                "headers": {
                    "Authorization": "Bearer sbg_st_YOUR_TOKEN"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "cleaning service management \u2014 book appointments, manage jobs, customer scheduling": {
            "shinebygrace": {
                "url": "https://shinebygrace.co.uk/api/mcp",
                "headers": {
                    "Authorization": "Bearer sbg_st_YOUR_TOKEN"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cleaning service management \u2014 book appointments, manage jobs, customer scheduling": {
            "shinebygrace": {
                "url": "https://shinebygrace.co.uk/api/mcp",
                "headers": {
                    "Authorization": "Bearer sbg_st_YOUR_TOKEN"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cleaning service management \u2014 book appointments, manage jobs, customer scheduling": {
            "shinebygrace": {
                "url": "https://shinebygrace.co.uk/api/mcp",
                "headers": {
                    "Authorization": "Bearer sbg_st_YOUR_TOKEN"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "cleaning service management \u2014 book appointments, manage jobs, customer scheduling": {
            "shinebygrace": {
                "url": "https://shinebygrace.co.uk/api/mcp",
                "headers": {
                    "Authorization": "Bearer sbg_st_YOUR_TOKEN"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cleaning service management \u2014 book appointments, manage jobs, customer scheduling": {
            "shinebygrace": {
                "url": "https://shinebygrace.co.uk/api/mcp",
                "headers": {
                    "Authorization": "Bearer sbg_st_YOUR_TOKEN"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cleaning service management \u2014 book appointments, manage jobs, customer scheduling": {
            "shinebygrace": {
                "url": "https://shinebygrace.co.uk/api/mcp",
                "headers": {
                    "Authorization": "Bearer sbg_st_YOUR_TOKEN"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "cleaning service management \u2014 book appointments, manage jobs, customer scheduling": {
            "shinebygrace": {
                "url": "https://shinebygrace.co.uk/api/mcp",
                "headers": {
                    "Authorization": "Bearer sbg_st_YOUR_TOKEN"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cleaning service management \u2014 book appointments, manage jobs, customer scheduling": {
            "shinebygrace": {
                "url": "https://shinebygrace.co.uk/api/mcp",
                "headers": {
                    "Authorization": "Bearer sbg_st_YOUR_TOKEN"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cleaning service management \u2014 book appointments, manage jobs, customer scheduling": {
            "shinebygrace": {
                "url": "https://shinebygrace.co.uk/api/mcp",
                "headers": {
                    "Authorization": "Bearer sbg_st_YOUR_TOKEN"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "cleaning service management \u2014 book appointments, manage jobs, customer scheduling": {
            "shinebygrace": {
                "url": "https://shinebygrace.co.uk/api/mcp",
                "headers": {
                    "Authorization": "Bearer sbg_st_YOUR_TOKEN"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cleaning service management \u2014 book appointments, manage jobs, customer scheduling": {
            "shinebygrace": {
                "url": "https://shinebygrace.co.uk/api/mcp",
                "headers": {
                    "Authorization": "Bearer sbg_st_YOUR_TOKEN"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cleaning service management \u2014 book appointments, manage jobs, customer scheduling": {
            "shinebygrace": {
                "url": "https://shinebygrace.co.uk/api/mcp",
                "headers": {
                    "Authorization": "Bearer sbg_st_YOUR_TOKEN"
                }
            }
        }
    }
}

From the repository

Bearer token authentication. Tokens are scoped:
- Staff tokens (sbg_st_) — generated by admins in the dashboard
- Customer tokens (sbg_cu_) — generated by customers in their portal

`get_available_slots`

check available booking times

`create_booking`

book a cleaning appointment

`cancel_job`

cancel an upcoming job

`request_reschedule`

request a job reschedule

`send_message_to_agent`

message your assigned cleaner

`send_message_to_manager`

escalate to management

`list_jobs`

list scheduled jobs

`create_job`

schedule a new cleaning job

`update_job`

modify job details

`complete_job`

mark a job as complete

`list_customers`

list all customers

`get_customer`

get customer details

`assign_agent_access`

assign a cleaner to a customer

Customer tools (token prefix sbg_cu_):
- get_available_slots — check available booking times
- create_booking — book a cleaning appointment
- cancel_job — cancel an upcoming job
- request_reschedule — request a job reschedule
- send_message_to_agent — message your assigned cleaner
- send_message_to_manager — escalate to management

Staff tools (token prefix sbg_st_):
- list_jobs — list scheduled jobs
- create_job — schedule a new cleaning job
- update_job — modify job details
- complete_job — mark a job as complete
- list_customers — list all customers
- get_customer — get customer details
- assign_agent_access — assign a cleaner to a customer

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "cleaning service management \u2014 book appointments, manage jobs, customer scheduling": {
            "shinebygrace": {
                "url": "https://shinebygrace.co.uk/api/mcp",
                "headers": {
                    "Authorization": "Bearer sbg_st_YOUR_TOKEN"
                }
            }
        }
    }
}

McpServers

{
    "shinebygrace": {
        "url": "https://shinebygrace.co.uk/api/mcp",
        "headers": {
            "Authorization": "Bearer sbg_st_YOUR_TOKEN"
        }
    }
}

ShineByGrace MCP Server

A cleaning service management platform with 13 AI-callable tools.

Tools

Customer tools (token prefix sbg_cu_): - get_available_slots — check available booking times - create_booking — book a cleaning appointment - cancel_job — cancel an upcoming job - request_reschedule — request a job reschedule - send_message_to_agent — message your assigned cleaner - send_message_to_manager — escalate to management Staff tools (token prefix sbg_st_): - list_jobs — list scheduled jobs - create_job — schedule a new cleaning job - update_job — modify job details - complete_job — mark a job as complete - list_customers — list all customers - get_customer — get customer details - assign_agent_access — assign a cleaner to a customer

Authentication

Bearer token authentication. Tokens are scoped: - Staff tokens (sbg_st_) — generated by admins in the dashboard - Customer tokens (sbg_cu_) — generated by customers in their portal

Connect


claude mcp add --transport http shinebygrace https://shinebygrace.co.uk/api/mcp --header "Authorization: Bearer sbg_st_YOUR_TOKEN"

Links

- Website: https://shinebygrace.co.uk - OpenAPI spec: https://shinebygrace.co.uk/openapi.json - A2A Agent Card: https://shinebygrace.co.uk/.well-known/agent.json

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Explore

Setting up with Highlight

From the repository

get_available_slots

create_booking

cancel_job

request_reschedule

send_message_to_agent

send_message_to_manager

list_jobs

create_job

update_job

complete_job

list_customers

get_customer

assign_agent_access

Claude Desktop / Cursor

McpServers

ShineByGrace MCP Server

Tools

Authentication

Connect

Links

More like this

Brave Search

🔎 GPT Researcher

Github SSE

AWS MCP Servers

`get_available_slots`

`create_booking`

`cancel_job`

`request_reschedule`

`send_message_to_agent`

`send_message_to_manager`

`list_jobs`

`create_job`

`update_job`

`complete_job`

`list_customers`

`get_customer`

`assign_agent_access`