Slotlock
Booking calendar MCP and A2A server where PostgreSQL rejects double bookings
- Pricing
- Freemium
- Platforms
- API, self-hosted, Web
- Runs
- Remotely
- Version
- 0.12.3
- Listing updated
- 3 days ago
About Slotlock
Slotlock is a freemium MCP server for productivity. It runs as a hosted remote server, so there is nothing to install locally.
Slotlock gives each reservable resource, such as a van, room or machine, its own calendar with a time zone and weekly hours. Agents ask for certain free slots, hold up to five while a person picks one in the chat, then book one; the rest are freed and unbooked holds expire on their own.
Overlaps are decided by a PostgreSQL exclusion constraint, so when two agents race for the same time, one wins and the other gets an answer it can act on, such as the next free slot. Free/busy answers say whether they are certain, so an unsynced calendar counts as unproven rather than free. Writes are idempotent and take an expected revision.
It can be used through hosted Slotlock Cloud, self-hosted with Docker or npm, or as a TypeScript library, over MCP, A2A or REST. The hosted tier is best effort with no SLA.
Install
Run in a terminal
claude mcp add slotlock --env DATABASE_URL='<DATABASE_URL>' --env SLOTLOCK_AUTH_TOKEN='<SLOTLOCK_AUTH_TOKEN>' --env SLOTLOCK_CONFIRMATION_SECRET='<SLOTLOCK_CONFIRMATION_SECRET>' --env SLOTLOCK_METRICS_TOKEN='<SLOTLOCK_METRICS_TOKEN>' --env SLOTLOCK_MIGRATE_DATABASE_URL='<SLOTLOCK_MIGRATE_DATABASE_URL>' -- docker run -i --rm -e DATABASE_URL -e SLOTLOCK_AUTH_TOKEN -e SLOTLOCK_CONFIRMATION_SECRET -e SLOTLOCK_METRICS_TOKEN -e SLOTLOCK_MIGRATE_DATABASE_URL ghcr.io/pilotaai/slotlock:0.12.3Add to claude_desktop_config.json
{
"mcpServers": {
"slotlock": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"DATABASE_URL",
"-e",
"SLOTLOCK_AUTH_TOKEN",
"-e",
"SLOTLOCK_CONFIRMATION_SECRET",
"-e",
"SLOTLOCK_METRICS_TOKEN",
"-e",
"SLOTLOCK_MIGRATE_DATABASE_URL",
"ghcr.io/pilotaai/slotlock:0.12.3"
],
"env": {
"DATABASE_URL": "<DATABASE_URL>",
"SLOTLOCK_AUTH_TOKEN": "<SLOTLOCK_AUTH_TOKEN>",
"SLOTLOCK_CONFIRMATION_SECRET": "<SLOTLOCK_CONFIRMATION_SECRET>",
"SLOTLOCK_METRICS_TOKEN": "<SLOTLOCK_METRICS_TOKEN>",
"SLOTLOCK_MIGRATE_DATABASE_URL": "<SLOTLOCK_MIGRATE_DATABASE_URL>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"slotlock": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"DATABASE_URL",
"-e",
"SLOTLOCK_AUTH_TOKEN",
"-e",
"SLOTLOCK_CONFIRMATION_SECRET",
"-e",
"SLOTLOCK_METRICS_TOKEN",
"-e",
"SLOTLOCK_MIGRATE_DATABASE_URL",
"ghcr.io/pilotaai/slotlock:0.12.3"
],
"env": {
"DATABASE_URL": "<DATABASE_URL>",
"SLOTLOCK_AUTH_TOKEN": "<SLOTLOCK_AUTH_TOKEN>",
"SLOTLOCK_CONFIRMATION_SECRET": "<SLOTLOCK_CONFIRMATION_SECRET>",
"SLOTLOCK_METRICS_TOKEN": "<SLOTLOCK_METRICS_TOKEN>",
"SLOTLOCK_MIGRATE_DATABASE_URL": "<SLOTLOCK_MIGRATE_DATABASE_URL>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"slotlock": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"DATABASE_URL",
"-e",
"SLOTLOCK_AUTH_TOKEN",
"-e",
"SLOTLOCK_CONFIRMATION_SECRET",
"-e",
"SLOTLOCK_METRICS_TOKEN",
"-e",
"SLOTLOCK_MIGRATE_DATABASE_URL",
"ghcr.io/pilotaai/slotlock:0.12.3"
],
"env": {
"DATABASE_URL": "<DATABASE_URL>",
"SLOTLOCK_AUTH_TOKEN": "<SLOTLOCK_AUTH_TOKEN>",
"SLOTLOCK_CONFIRMATION_SECRET": "<SLOTLOCK_CONFIRMATION_SECRET>",
"SLOTLOCK_METRICS_TOKEN": "<SLOTLOCK_METRICS_TOKEN>",
"SLOTLOCK_MIGRATE_DATABASE_URL": "<SLOTLOCK_MIGRATE_DATABASE_URL>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"slotlock": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"DATABASE_URL",
"-e",
"SLOTLOCK_AUTH_TOKEN",
"-e",
"SLOTLOCK_CONFIRMATION_SECRET",
"-e",
"SLOTLOCK_METRICS_TOKEN",
"-e",
"SLOTLOCK_MIGRATE_DATABASE_URL",
"ghcr.io/pilotaai/slotlock:0.12.3"
],
"env": {
"DATABASE_URL": "<DATABASE_URL>",
"SLOTLOCK_AUTH_TOKEN": "<SLOTLOCK_AUTH_TOKEN>",
"SLOTLOCK_CONFIRMATION_SECRET": "<SLOTLOCK_CONFIRMATION_SECRET>",
"SLOTLOCK_METRICS_TOKEN": "<SLOTLOCK_METRICS_TOKEN>",
"SLOTLOCK_MIGRATE_DATABASE_URL": "<SLOTLOCK_MIGRATE_DATABASE_URL>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"slotlock": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"DATABASE_URL",
"-e",
"SLOTLOCK_AUTH_TOKEN",
"-e",
"SLOTLOCK_CONFIRMATION_SECRET",
"-e",
"SLOTLOCK_METRICS_TOKEN",
"-e",
"SLOTLOCK_MIGRATE_DATABASE_URL",
"ghcr.io/pilotaai/slotlock:0.12.3"
],
"env": {
"DATABASE_URL": "<DATABASE_URL>",
"SLOTLOCK_AUTH_TOKEN": "<SLOTLOCK_AUTH_TOKEN>",
"SLOTLOCK_CONFIRMATION_SECRET": "<SLOTLOCK_CONFIRMATION_SECRET>",
"SLOTLOCK_METRICS_TOKEN": "<SLOTLOCK_METRICS_TOKEN>",
"SLOTLOCK_MIGRATE_DATABASE_URL": "<SLOTLOCK_MIGRATE_DATABASE_URL>"
}
}
}
}Configuration
DATABASE_URLpostgres:// URL of a PostgreSQL 16 or newer database the container can reach, as a role that is not a superuser and has no BYPASSRLS: serve refuses one, since row-level security would not confine it. Without SLOTLOCK_MIGRATE_DATABASE_URL this role also applies the schema, so it must be able to create it.RequiredSLOTLOCK_AUTH_TOKENOptional bearer token for SLOTLOCK_TENANT, with read and write (never admin): at least 32 random characters (openssl rand -hex 32). Leave it unset to accept only API keys (slotlock key create).SLOTLOCK_CONFIRMATION_SECRETSigns pending write confirmations: at least 32 random characters, different from the token. Required unless SLOTLOCK_CONFIRM_WRITES is none.SLOTLOCK_METRICS_TOKENServes Prometheus metrics at /metrics to this bearer token: at least 32 random characters, different from every other secret. Off without it.PORTPort the server listens on inside the container.SLOTLOCK_MIGRATE_DATABASE_URLpostgres:// URL of the schema owner. When set, migration runs as this role and grants the DATABASE_URL role only what it needs at runtime.SLOTLOCK_CONFIRM_WRITESWrites that wait for a person to confirm them: none, all, or a comma-separated list of slotlock_create_event, slotlock_book_together, slotlock_book_pool, slotlock_update_event, slotlock_delete_event, slotlock_confirm_slot, slotlock_reschedule, slotlock_cancel. Listing one also guards the tool that makes the same write (slotlock_cancel with slotlock_delete_event, slotlock_reschedule with slotlock_update_event, slotlock_confirm_slot with slotlock_create_event). Clients without MCP 2026-07-28 form elicitation have guarded writes refused.SLOTLOCK_AVAILABILITYJSON array of weekly bookable-hours rules, e.g. [{"rrule":"FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR","startMinutes":540,"durationMinutes":480}]. Without rules no slot is ever offered.SLOTLOCK_REST_APIon: also serve the tools as a REST API under /v1, and the application API (resources, bookable hours, holds, reservations, coverage, maintenance) for admin keys, described by an OpenAPI 3.1 document at /openapi.json. Writes that wait for confirmation answer 428 there. off: MCP and A2A only.SLOTLOCK_RETENTION_DAYSDays of history kept: the change feed (who made each change included) and how far back a cursor reaches, and ended waitlist entries; retried writes are answered for at least 30 days whatever it is. 1-3650; default 30.SLOTLOCK_SHARED_LIMITSon: tenant request budgets (SLOTLOCK_LIMITS' tenant_* and app_*) are shared by every server of a deployment through PostgreSQL, so N servers allow a tenant its rate once, not N times. off: each server keeps its own.SLOTLOCK_WEBHOOKSon: deliver each tenant's changes to its webhooks (POST /v1/webhooks), signed as Standard Webhooks; never to a private network address. private: those too, for testing. off: keep the change feed (GET /v1/changes), send nothing.SLOTLOCK_TENANTThe tenant SLOTLOCK_AUTH_TOKEN acts in; API keys act in their own tenant.
Tools this server provides (8)
Taken from the project documentation; the running server may differ.
- slotlock_create_event
- Creates a booking event.
- slotlock_update_event
- Updates an event.
- slotlock_delete_event
- Deletes an event.
- slotlock_confirm_slot
- Confirms a held slot.
- slotlock_reschedule
- Moves a booking.
- slotlock_cancel
- Cancels a booking.
- slotlock_book_pool
- Books from a pool of resources.
- slotlock_book_together
- Books several resources together.
What it does
- Per-resource calendars
- Each resource has its own time zone and hours.
- Holds that expire
- Hold up to five slots while a person chooses.
- Overlap protection
- A database constraint admits one winner.
- Certain free/busy
- Says when availability is unproven.
- Waitlists
- Freed time goes to the next in line as a hold.
- Three ways to run
- Cloud, Docker self-host or library.
Good for
- Let agents book rental vans without clashes
- Reserve meeting rooms or machines
- Offer a person up to five slots to pick from
- Reschedule or cancel bookings through chat
- Add booking to your own Node.js service
Pricing
Freemium
Free, Developer and Team tiers; prices on slotlock.pylota.io/pricing
Prices change. Check slotlock.pylota.io before you buy.
Slotlock FAQ
How are double bookings prevented?
A PostgreSQL exclusion constraint checks every write.
What if two agents want the same slot?
One gets it and the other receives the next free time.
Can I self-host?
Yes, with Docker or from npm.
Is there a free plan?
Slotlock Cloud starts on Free with no card, with Developer and Team tiers above it.
Is Slotlock free?
Slotlock has a free plan, with paid plans for more usage or features.
How do I add Slotlock to Claude Code?
Run this command in your terminal: claude mcp add slotlock --env DATABASE_URL='<DATABASE_URL>' --env SLOTLOCK_AUTH_TOKEN='<SLOTLOCK_AUTH_TOKEN>' --env SLOTLOCK_CONFIRMATION_SECRET='<SLOTLOCK_CONFIRMATION_SECRET>' --env SLOTLOCK_METRICS_TOKEN='<SLOTLOCK_METRICS_TOKEN>' --env SLOTLOCK_MIGRATE_DATABASE_URL='<SLOTLOCK_MIGRATE_DATABASE_URL>' -- docker run -i --rm -e DATABASE_URL -e SLOTLOCK_AUTH_TOKEN -e SLOTLOCK_CONFIRMATION_SECRET -e SLOTLOCK_METRICS_TOKEN -e SLOTLOCK_MIGRATE_DATABASE_URL ghcr.io/pilotaai/slotlock:0.12.3
What are the best alternatives to Slotlock?
The closest alternatives to Slotlock are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.
Alternatives to Slotlock

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

ConvertAudioToText
MCP serverTranscribe audio and video links from Claude or ChatGPT and read the results
Not checked yet- 5 tools
- Remote
- Freemium
- Design and media