Meetlys Model Context Protocol (MCP) Server

Empower your AI Assistants with Meetlys Infrastructure Yapay Zeka Asistanlarınızı Meetlys Altyapısıyla Güçlendirin

🇬🇧 English

The official Meetlys MCP Server bridges AI clients (Claude Desktop, Cursor, Antigravity, Windsurf, VS Code, Zed, Codex) directly to your Meetlys platform.

Features

• 📋 Task & Project Management: Create, update, list tasks, boards, and support tickets via conversational AI.
• 📅 Calendar & Planning: Automatically schedule meetings and create reminders based on your calendar availability.
• 👥 Team Management: Organize departments, manage teams, and assign members to projects.
• 🏖️ Leave & Balance Management: Submit leave requests, approve/reject pending leaves, check annual leave balances, and manage company leave types.
• 📁 File Handling: Read attachments and safely upload documents to tasks and tickets.

Setup & Configuration

Requires API_KEY and SECRET_KEY.

[!NOTE] You must get your API keys from the Meetlys > Profile > Profile Menu > Api Integrations screen in the Meetlys App.

Method 1: Local Execution (stdio)

Claude Desktop / Antigravity / Codex / VS Code (Cline & Roo Code)

Add to your client's MCP configuration file (mcpServers section):

{
  "mcpServers": {
    "meetlys-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "meetlys-mcp",
        "--api-key", "YOUR_API_KEY",
        "--secret-key", "YOUR_SECRET_KEY"
      ]
    }
  }
}

Cursor IDE

1. Go to Cursor Settings > Features > MCP.
2. Click Add New MCP Server.
3. Select Type command, Name Meetlys, and Command:

   npx -y meetlys-mcp --api-key YOUR_API_KEY --secret-key YOUR_SECRET_KEY

Windsurf Editor

Add to mcp.servers in settings:

"mcp.servers": {
  "meetlys": {
    "command": "npx",
    "args": ["-y", "meetlys-mcp", "--api-key", "YOUR_API_KEY", "--secret-key", "YOUR_SECRET_KEY"]
  }
}

Zed Editor

Add to context_servers in settings.json:

{
  "context_servers": {
    "meetlys-mcp": {
      "command": "npx",
      "args": ["-y", "meetlys-mcp", "--api-key", "YOUR_API_KEY", "--secret-key", "YOUR_SECRET_KEY"]
    }
  }
}

Method 2: Remote SSE Mode (mcp.meetlys.com)

Connect to the cloud endpoint without local process execution:

{
  "mcpServers": {
    "meetlys-remote": {
      "url": "https://mcp.meetlys.com/sse",
      "headers": {
        "x-api-key": "YOUR_API_KEY",
        "x-secret-key": "YOUR_SECRET_KEY"
      }
    }
  }
}

🇹🇷 Türkçe

Resmi Meetlys MCP Sunucusu, kullandığınız yapay zeka araçlarının (Claude Desktop, Cursor, Antigravity, Windsurf, VS Code, Zed, Codex) Meetlys platformunuzla doğrudan iletişim kurmasını sağlar.

Özellikler

• 📋 Görev ve Proje Yönetimi: Sohbet ederek görev, pano ve destek talebi oluşturun, listeleyin ve güncelleyin.
• 📅 Takvim ve Planlama: Takviminizdeki boşluklara göre otomatik toplantı ve görev hatırlatıcıları planlayın.
• 👥 Ekip Yönetimi: Departmanları düzenleyin, ekipleri yönetin ve projelere yeni üyeler atayın.
• 🏖️ İzin & Bakiye Yönetimi: İzin talebi oluşturun, onay süreçlerini yönetin (onay/red), yıllık izin bakiyelerini ve şirket izin tanımlarını sorgulayın.
• 📁 Dosya İşlemleri: Görev eklerini okuyun ve biletlere güvenli şekilde dosya yükleyin.

Kurulum ve Ayarlar

Gerekli bilgiler: API_KEY ve SECRET_KEY.

[!NOTE] API anahtarlarınızı almak için Meetlys App üzerinde Meetlys > Profil > Profil Menü > Api Entegrasyonları ekranını kullanmalısınız.

Yöntem 1: Yerel Çalıştırma (stdio)

Claude Desktop / Antigravity / Codex / VS Code (Cline & Roo Code)

Kullandığınız aracın konfigürasyon dosyasındaki mcpServers alanına ekleyin:

{
  "mcpServers": {
    "meetlys-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "meetlys-mcp",
        "--api-key", "SİZİN_API_ANAHTARINIZ",
        "--secret-key", "SİZİN_GİZLİ_ANAHTARINIZ"
      ]
    }
  }
}

Cursor IDE

1. Cursor Settings > Features > MCP sekmesine gidin.
2. Add New MCP Server butonuna tıklayın.
3. Tür olarak command, İsim Meetlys, Komut:

   npx -y meetlys-mcp --api-key SİZİN_API_ANAHTARINIZ --secret-key SİZİN_GİZLİ_ANAHTARINIZ

Windsurf Editor

Ayarlar dosyasındaki mcp.servers alanına ekleyin:

"mcp.servers": {
  "meetlys": {
    "command": "npx",
    "args": ["-y", "meetlys-mcp", "--api-key", "SİZİN_API_ANAHTARINIZ", "--secret-key", "SİZİN_GİZLİ_ANAHTARINIZ"]
  }
}

Zed Editor

settings.json içerisindeki context_servers alanına ekleyin:

{
  "context_servers": {
    "meetlys-mcp": {
      "command": "npx",
      "args": ["-y", "meetlys-mcp", "--api-key", "SİZİN_API_ANAHTARINIZ", "--secret-key", "SİZİN_GİZLİ_ANAHTARINIZ"]
    }
  }
}

Yöntem 2: Uzaktan Bağlantı (Remote SSE Modu)

Yerel işlem çalıştırmadan doğrudan bulut sunucusuna bağlanabilirsiniz:

{
  "mcpServers": {
    "meetlys-remote": {
      "url": "https://mcp.meetlys.com/sse",
      "headers": {
        "x-api-key": "SİZİN_API_ANAHTARINIZ",
        "x-secret-key": "SİZİN_GİZLİ_ANAHTARINIZ"
      }
    }
  }
}