Schedulia MCP - MCP Server

📅 Schedulia MCP - Meeting Scheduling Assistant

🚀 Getting Started

Prerequisites

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

⚙️ Setup Instructions

Get Your API Key
- Get your API key from schedulia.org 🔑

Clone Repository

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

Run Server

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

Configure MCP Server

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

🔧 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

How to Use

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

How to Use

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

How to Use

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

How to Use

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 MCP - Meeting Scheduling Assistant

🚀 Getting Started

Prerequisites

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

⚙️ Setup Instructions

Get Your API Key
- Get your API key from schedulia.org 🔑

Clone Repository

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

Run Server

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

Configure MCP Server

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

🔧 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

How to Use

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

How to Use

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

How to Use

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

How to Use

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! 🎥