slotixmcp 0.2.0

MCP Server for Slotix - AI-powered appointment management integration

Slotix MCP Server

MCP (Model Context Protocol) server for Slotix - AI-powered appointment management.

This server allows AI assistants like Claude Desktop and ChatGPT to manage your Slotix appointments, clients, and notifications directly through natural conversation.

Features

• Appointments: View, create, update, cancel, and reschedule appointments
• Clients: Search and view client information and history
• Availability: Check available time slots for booking
• Statistics: Get business insights (revenue, appointments, clients)
• Notifications: Send messages to clients via Telegram or WhatsApp
• Coupons: Create and send discount coupons with QR codes to clients

Prerequisites

• A Slotix account with an active subscription
• An API key (generate one in Slotix Settings > API & Integrations)

Installation

Claude Desktop

1. Install using uvx:

uvx slotixmcp

2. Configure Claude Desktop by editing claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "slotix": {
      "command": "uvx",
      "args": ["slotixmcp"],
      "env": {
        "SLOTIX_API_KEY": "sk_slotix_your_api_key_here"
      }
    }
  }
}

3. Restart Claude Desktop

ChatGPT (Developer Mode)

1. Enable Developer Mode in ChatGPT settings (requires Plus/Pro)
2. Go to Settings → Connectors → Advanced Settings → Developer Mode
3. Add the MCP server with your API key

Direct Installation (pip)

pip install slotixmcp

Configuration

Set the following environment variables:

Variable	Required	Description
SLOTIX_API_KEY	Yes	Your Slotix API key (starts with sk_slotix_)
SLOTIX_API_URL	No	API URL (default: https://api.slotix.it)

Available Tools

Tool	Description
get_profile	Get your professional profile information
get_appointments	Get appointments with optional date range and status filter
get_today_appointments	Get today's appointments
get_week_appointments	Get this week's appointments
get_appointment	Get details of a specific appointment
create_appointment	Create a new appointment
update_appointment	Update an existing appointment
cancel_appointment	Cancel an appointment
reschedule_appointment	Reschedule and optionally notify the client
get_clients	Get list of clients with optional search
get_client	Get detailed client information
get_availability	Get available time slots
get_stats	Get business statistics
send_notification	Send a message to a client
create_coupon	Create and send a discount coupon to a client

Example Conversations

Get today's schedule:

"What appointments do I have today?"

Reschedule an appointment:

"Move Mario Rossi's appointment to tomorrow at 3pm and let him know"

Check client history:

"Show me the appointment history for client Maria Bianchi"

Get business stats:

"How was my month? Show me the statistics"

Find available slots:

"When am I free next week?"

Send a discount coupon:

"Create a 10% discount coupon for client Mario Rossi"

Send a fixed amount coupon:

"Send a €5 coupon to the client with ID 42"

Development

Local Development

# Clone the repository
git clone https://github.com/slotix/SlotixMCP.git
cd SlotixMCP

# Install dependencies
pip install -e .

# Run the server
SLOTIX_API_KEY=your_key python -m slotixmcp.server

Testing with MCP Inspector

npx @modelcontextprotocol/inspector uvx slotixmcp

---

Publishing to MCP Stores

PyPI (Required for uvx installation)

1. Build the package:

pip install build twine
python -m build

2. Upload to PyPI:

# Test upload first
twine upload --repository testpypi dist/*

# Production upload
twine upload dist/*

Or using uv:

uv build
uv publish

MCP.so (Community Registry)

1. Go to mcp.so
2. Click "Submit Server"
3. Fill in the form with:
   • Name: Slotix
   • Repository: https://github.com/slotix/SlotixMCP
   • Description: AI-powered appointment management for professionals

Or submit via GitHub issue on their repository.

Smithery.ai

1. Visit smithery.ai
2. Sign in with GitHub
3. Submit your MCP server repository
4. Fill in the metadata and examples

Glama.ai

1. Go to glama.ai/mcp/servers
2. Click "Submit Server"
3. Provide repository URL and documentation

Anthropic MCP Directory (Official)

Requirements:

• Privacy policy accessible from your website
• Verified contact information
• Technical support availability
• OAuth 2.0 with valid certificates (for remote servers)
• 3+ working example use cases
• Compliance with Anthropic MCP Directory Policy

Process:

1. Ensure your server meets all security and privacy requirements
2. Prepare test account with sample data
3. Submit via Claude Partners
4. Wait for review (can take several weeks)

---

Security

• Never share your API key publicly
• The API key provides full access to your Slotix account
• Revoke and regenerate keys if compromised
• Use environment variables, not hardcoded keys

Support

• Documentation: docs.slotix.it
• Issues: GitHub Issues
• Email: [e-mail]

License

MIT License - see LICENSE for details.