Schedulia

Schedulia MCP Server lets you run a local MCP endpoint that interacts with the Schedulia scheduling API. It enables you to view, request, and respond to meeting times through a simple, scriptable interface that your MCP client can call.

How to use

You will run the MCP server locally and connect your MCP client to it. Start the server with your API key, then register it on your host so your clients can reach it. Use the provided tools to view schedules, view meeting requests, respond to requests, and create new meeting requests.

How to install

Prerequisites you need before installing: Git, Python, and UV (Python Package Manager). You will install UV using its setup guide, then clone the MCP server repository, and finally run the server with your API key.

# Prerequisites
# - Git
# - Python
# - UV (Python Package Manager)

# Step 1: Get your API key from schedulia.org
# (You will replace {your-api-key} with your actual key)

# Step 2: Clone the MCP server repository
git clone https://github.com/watanka/schedulia-mcp.git
cd schedulia-mcp

# Step 3: Run the MCP server locally
uv run server.py --api-key={your-api-key}

Configuration and deployment

Configure your MCP server entry in your host environment to point to the local MCP server. The example below shows how to wire the server with UV and the API key in your MCP configuration.

{
  "mcpServers": {
    "schedulia-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp/server",
        "run",
        "server.py",
        "--api-key",
        "{your-api-key}"
      ]
    }
  }
}

Register MCP Server on your host

Register the MCP server so your MCP client can connect to it. Provide the full path to your MCP server and the API key when you start the service.

# The exact registration steps depend on your host environment.
# Example placeholder for registration:
# host_register_schedulia --server schedulia-mcp --endpoint http://localhost:8000

Notes and tips

• Keep your API key secure and avoid exposing it in logs or public commands.
• Ensure the directory path used in configuration points to the location where your server.py resides.
• If you change the API key, restart the MCP server with the new key in the command line.

Available tools

view_meeting_schedules

View all scheduled meetings for a specific date or fetch all upcoming schedules.

view_meeting_requests

Check all incoming meeting requests and see their details and available times.

respond_to_meeting_request

Accept or decline a meeting request with a selected time slot.

request_meeting

Create and send a new meeting request to a receiver with multiple available times and a description.