# Slotlock

> Slotlock is a freemium MCP server for productivity. Booking calendar MCP and A2A server where PostgreSQL rejects double bookings. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, self-hosted, Web
- **Website:** https://slotlock.pylota.io
- **Repository:** https://github.com/pilotaai/slotlock
- **MCP Registry name:** io.github.PILOTAAI/slotlock
- **Categories:** productivity
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `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.

## 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

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/slotlock
