📅 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}" ] } } } -
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
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! 🎥

