OnlineAfspraken Slots MCP server

OnlineAfspraken slots MCP

<!-- mcp-name: io.github.RichieB2B/onlineafspraken-slots -->

Read available slots from a public OnlineAfspraken widget URL without an account. This local MCP server reads availability only; it cannot make a booking.

Get started

You need Python 3.10 or newer and an MCP client. The commands below use a Unix shell (macOS or Linux).

1. Download or clone this repository.
2. In its directory, install the package and its dependencies:

sh setup.sh

Replace /absolute/path/to/onlineafspraken-slots-mcp with the full path to your downloaded copy.

1. Register the server with your MCP client using one of the examples below.

example: “Show today's available times for this widget: [paste the full widget URL here].”

1. Start a new chat and provide a public OnlineAfspraken widget URL. For

You can also pass the URL of a public booking page that embeds one OnlineAfspraken widget. If the page has several widgets, use the direct URL of the one you want.

Connect your MCP client

Codex

codex mcp add onlineafspraken-slots -- /absolute/path/to/onlineafspraken-slots-mcp/run.sh
codex mcp list

Claude Code

claude mcp add --scope user --transport stdio onlineafspraken-slots -- /absolute/path/to/onlineafspraken-slots-mcp/run.sh
claude mcp list

The user scope makes the server available in all your Claude Code projects. See the Claude Code MCP documentation for other scopes.

Claude Desktop

Add this entry under mcpServers in your Claude Desktop configuration, then restart Claude Desktop:

{
  "mcpServers": {
    "onlineafspraken-slots": {
      "command": "/absolute/path/to/onlineafspraken-slots-mcp/run.sh"
    }
  }
}

If you already have an mcpServers object, add just the onlineafspraken-slots entry to it. The Claude Desktop local server guide explains where to manage local servers and check their connection status.

OpenCode

opencode mcp add onlineafspraken-slots --global -- /absolute/path/to/onlineafspraken-slots-mcp/run.sh
opencode mcp list

The global option makes the server available in every OpenCode project. See the OpenCode MCP documentation for project-specific configuration.

After the first PyPI release, clients that support a package runner can launch the onlineafspraken-slots-mcp command from that package instead of using a local checkout.

Tool inputs

The server exposes getavailableslots:

Results include the appointment type names, available start times, date, timezone, and the time the availability was checked. The room input is named for the original use case; it works with any appointment type.

Limitations

The server uses the widget's public, undocumented read endpoint. A provider change may require an update. A booking page must expose its widget URL in a script, iframe, or link for automatic discovery. Available slots can change between lookup and booking.

License

MIT

Publishing a release

For maintainers: keep the version in pyproject.toml and server.json in sync. To publish the first release, configure a pending PyPI trusted publisher with these values:

Shortened. The full README is on GitHub.