Skip to main content
Glama

📅 Schedulia MCP - Meeting Scheduling Assistant

Related MCP server: MCP Calendar Assistant

🚀 Getting Started

Prerequisites

✅ Git
✅ Python
✅ UV (Python Package Manager) - UV Installation Guide

⚙️ Setup Instructions

  1. Get Your API Key

  2. Clone Repository

    git clone https://github.com/watanka/schedulia-mcp.git
    cd schedulia-mcp
  3. Run Server

    uv run server.py --api-key={your-api-key}  # Replace with your API key!
  4. Configure MCP Server

    {
        "mcpServers": {
            "schedulia-mcp": {
                "command": "uv",
                "args": [
                    "--directory",
                    "/path/to/mcp/server",
                    "run",
                    "server.py",
                    "--api-key",
                    "{your-api-key}"
                ]
            }
        }
    }
  5. Register MCP Server on your host(Claude Desktop, Cursor)

🔧 Integration Options

For Claude Desktop users: Configuration Guide
For Cursor users: Configuration Guide

🛠️ Available Tools

📊 View Meeting Schedules

view_meeting_schedules(date): Check all scheduled meetings for a specific date

Ask to see your meetings using the view_meeting_schedules tool. You can specify a date or view all schedules.

Prompt Examples:

  • "Please show me my meeting schedules"

  • "Can you check my meetings for today using view_meeting_schedules?"

  • "Use view_meeting_schedules to show my upcoming meetings"

Example Response:

{
    "id": 1,
    "host": {"name": "John Doe", "email": "john@example.com"},
    "participants": [
        {"name": "Alice Smith", "email": "alice@example.com"}
    ],
    "time": {
        "start_time": "2024-03-20T14:00:00",
        "end_time": "2024-03-20T15:00:00"
    },
    "title": "Project Review",
    "description": "Weekly sync meeting"
}

📬 View Meeting Requests

view_meeting_requests(): Check all incoming meeting requests

Use the view_meeting_requests tool to check any pending meeting invitations.

Prompt Examples:

  • "Use view_meeting_requests to show my pending invitations"

  • "Check my meeting requests using view_meeting_requests tool"

  • "Show me all meeting requests in the system"

Example Response:

{
    "request_id": 1,
    "sender": {"name": "Alice Smith", "email": "alice@example.com"},
    "receiver_email": "john@example.com",
    "available_times": [
        {
            "start_time": "2024-03-21T15:00:00",
            "end_time": "2024-03-21T16:00:00"
        }
    ],
    "status": "PENDING",
    "title": "Product Discussion"
}

✅ Respond to Meeting Request

respond_to_meeting_request(request_id, accept, selected_time): Accept or decline meeting requests

This is a two-step process using both view_meeting_requests and respond_to_meeting_request tools.

Step 1 - View Requests:

  • "First, use view_meeting_requests to show me pending invitations"

  • "Let me check the meeting requests using view_meeting_requests tool"

Step 2 - Respond:

  • "Use respond_to_meeting_request to accept request ID 1 with the proposed time slot"

  • "Please use respond_to_meeting_request to decline meeting request #2"

Example Conversation:

User: "First, show me my meeting requests using view_meeting_requests"
Assistant: "Here are your pending meeting requests: [shows requests]"
User: "Great, I want to accept request ID 1 using respond_to_meeting_request for the March 21st 15:00-16:00 slot"

📨 Send Meeting Request

request_meeting(receiver_email, available_times, title, description): Create and send new meeting requests

Use the request_meeting tool to create new meeting requests. You'll need to provide receiver's email, available times, title, and description.

Prompt Examples:

  • "Use request_meeting to schedule a meeting with alice@example.com"

  • "I need to send a meeting request using request_meeting tool for tomorrow"

  • "Create a new meeting request with request_meeting for the team sync"

Example Request:

"Please use request_meeting to set up a meeting with following details:
- Receiver: alice@example.com
- Title: Project Kickoff
- Description: Initial project planning meeting
- Available times: 
  - March 25th, 2024 14:00-15:00
  - March 26th, 2024 11:00-12:00"

Example Response:

{
    "request_id": 3,
    "sender": {"name": "John Doe", "email": "john@example.com"},
    "receiver_email": "alice@example.com",
    "available_times": [
        {
            "start_time": "2024-03-25T14:00:00",
            "end_time": "2024-03-25T15:00:00"
        },
        {
            "start_time": "2024-03-26T11:00:00",
            "end_time": "2024-03-26T12:00:00"
        }
    ],
    "status": "PENDING",
    "title": "Project Kickoff",
    "description": "Initial project planning meeting"
}

Demo

  • Need help? Check out demo videos! 🎥

Schedulia Demo

Available Tools

4 tools
request_meetingD

Inputs: receiver_email (required), available_times (required), title (required), description (required).

respond_to_meeting_requestD

Inputs: request_id (required), accept (required), selected_time (required).

view_meeting_requestsD

Inputs: no named parameters.

view_meeting_schedulesD

Inputs: date.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no overlap: requesting meetings, responding to requests, viewing requests, and viewing schedules. The actions (request, respond, view) and targets (meeting_requests, meeting_schedules) are well-defined, making it easy for an agent to select the correct tool.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern using snake_case (e.g., request_meeting, respond_to_meeting_request). The naming is predictable and readable throughout the set, with no deviations in style or convention.

    Tool Count4/5

    With 4 tools, the count is reasonable for a scheduling/meeting domain, covering core actions like request, respond, and view. It might be slightly thin if advanced features (e.g., cancel_meeting, update_schedule) are expected, but it's well-scoped for basic functionality.

    Completeness3/5

    The tools cover key aspects of meeting management (requesting, responding, viewing), but there are notable gaps. For example, there's no tool to cancel or modify meetings, and no direct scheduling creation tool, which could limit agent workflows in a full meeting lifecycle.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to intelligently schedule meetings by checking Microsoft Outlook calendars, finding available time slots across multiple participants, and automatically booking meetings with Teams integration. Uses Microsoft Graph API with smart fallback logic for optimal scheduling.
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to manage calendars and tasks through natural language, supporting Google Calendar operations like event creation, availability checking, and smart scheduling. It features schedule analysis, task reminders, and meeting time recommendations to streamline productivity.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Integrates the MeetSync calendar negotiation API to enable AI agents to autonomously manage participants, find mutual availability, and handle meeting bookings. It exposes 19 tools for end-to-end scheduling workflows including participant preferences, proposals, and confirmations.
      19
      7 npm
      MIT