Yapay zeka ajanlarının uygunluk kontrolü, toplantı rezervasyonu, iptal ve yeniden planlama dahil olmak üzere takvim yönetimi görevlerini yürütmesini sağlar.
Ayrıca bilinen adı astrocal-dev/mcp-server, mcp-server, @astrocal/mcp-server
- Yıldızlar
- 1
- Araçlar
- 18
- İndirmeler, 30 gün
- 220
- En son sürüm
- 0.1.6
- Son commit
- 10 Eki 2026
- Lisans
- MIT
Astrocal MCP nedir?
Yapay zeka ajanlarının uygunluk kontrolü, toplantı rezervasyonu, iptal ve yeniden planlama dahil olmak üzere takvim yönetimi görevlerini yürütmesini sağlar. 18 araç sunar; örneğin event_type_id, start_date, end_date.
Özet, projenin README dosyasından oluşturuldu
Astrocal MCP sunucusu hakkında
Astrocal, yapay zeka ajanlarının doğal konuşma yoluyla karmaşık planlama iş akışlarını yönetebilmesi için özelleşmiş bir arayüz sunar. Bu MCP server; Claude Desktop, Cursor ve Windsurf gibi istemcilerin Astrocal planlama platformuyla doğrudan etkileşime girmesine olanak tanır. Ajanların uygunluk kontrolü, toplantı rezervasyonu, randevu iptali ve bekleme listesi yönetimi dahil olmak üzere sekiz farklı eylemi gerçekleştirmesini sağlar. Google Calendar, Microsoft 365 ve CalDAV ile bağlantı kurduğu için ajan her zaman gerçek zamanlı uygunluk verileriyle çalışır.
Geliştiriciler bu yapıyı npx kullanarak yerel olarak kurabilir veya paketi npm aracılığıyla global olarak yükleyebilirler. Entegrasyon için bir ASTROCAL_API_KEY gereklidir; kullanıcılar, geliştirme sırasında gerçek e-postaların veya takvim etkinliklerinin oluşturulmasını önlemek için test anahtarlarıyla sandbox modunu kullanabilirler. Sistem ayrıca Stripe Connect entegrasyonu aracılığıyla ücretli danışmanlıkları da destekleyerek ajanların planlama ile birlikte işlemleri de yönetmesine imkan tanır. Kullanıcılar, ortam değişkenlerinde (environment variables) varsayılan bir etkinlik türü ID'si belirleyerek deneyimi daha da özelleştirebilirler.
Neler yapabilirsiniz
- 1Müsait zaman dilimlerini doğrulayınBelirli bir tarih aralığında, belirli bir etkinlik türü için uygun zamanları bulması için ajana komut verin.
- 2Toplantı rezervasyonlarını otomatize edinAsistanın, kullanıcının adını ve e-postasını kullanarak bir danışmanlık randevusu almasını sağlayın.
- 3Mevcut randevuları değiştirinPlanlanmış bir toplantının farklı bir saate taşınması için ajandan talepte bulunun.
- 4Randevu bekleme listelerini yönetinTüm slotlar dolu olduğunda bir kişiyi bekleme listesine eklemesi için ajana talimat verin.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Astrocal MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleAstrocal MCP'yi Claude Code içine yükleyin
$ claude mcp add --env 'ASTROCAL_API_KEY=<YOUR_ASTROCAL_API_KEY>' mcp-server -- npx -y @astrocal/mcp-serverAstrocal MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@astrocal/mcp-server"
],
"env": {
"ASTROCAL_API_KEY": "<YOUR_ASTROCAL_API_KEY>"
}
}
}
}Astrocal MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@astrocal/mcp-server"
],
"env": {
"ASTROCAL_API_KEY": "<YOUR_ASTROCAL_API_KEY>"
}
}
}
}Astrocal MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"mcp-server","type":"stdio","command":"npx","args":["-y","@astrocal/mcp-server"],"env":{"ASTROCAL_API_KEY":"<YOUR_ASTROCAL_API_KEY>"}}'Astrocal MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@astrocal/mcp-server"
],
"env": {
"ASTROCAL_API_KEY": "<YOUR_ASTROCAL_API_KEY>"
}
}
}
}Astrocal MCP'yi Codex içine yükleyin
$ codex mcp add mcp-server --env 'ASTROCAL_API_KEY=<YOUR_ASTROCAL_API_KEY>' -- npx -y @astrocal/mcp-serverAstrocal MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.mcp-server] command = "npx" args = ["-y", "@astrocal/mcp-server"] [mcp_servers.mcp-server.env] ASTROCAL_API_KEY = "<YOUR_ASTROCAL_API_KEY>"
Astrocal MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user -e 'ASTROCAL_API_KEY=<YOUR_ASTROCAL_API_KEY>' mcp-server npx -- -y @astrocal/mcp-serverAstrocal MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@astrocal/mcp-server"
],
"env": {
"ASTROCAL_API_KEY": "<YOUR_ASTROCAL_API_KEY>"
}
}
}
}Astrocal MCP araçları 18
README dosyasından algılandıevent_type_idstart_dateend_datetimezonestart_timeinvitee_nameinvitee_emailinvitee_timezonenotesbooking_idreasonnew_start_time
| event_type_id | — | |
| start_date | — | |
| end_date | — | |
| timezone | — | |
| start_time | — | |
| invitee_name | — | |
| invitee_email | — | |
| invitee_timezone | — | |
| notes | — | |
| booking_id | — | |
| reason | — | |
| new_start_time | — |
18 aracın tümünü gösterDaha az araç göster
statuslimitnameemailpreferred_timeswaitlist_entry_id
| status | — | |
| limit | — | |
| name | — | |
| — | ||
| preferred_times | — | |
| waitlist_entry_id | — |
Yapılandırma
ASTROCAL_API_KEYGerekliGizliYour Astrocal API key (create one at https://astrocal.dev/dashboard/connect)
ASTROCAL_API_URLCustom API base URL (defaults to https://api.astrocal.dev)
ASTROCAL_DEFAULT_EVENT_TYPE_IDDefault event type ID when not specified in tool calls
| Ad | Açıklama | Sunucu |
|---|---|---|
| ASTROCAL_API_KEY | Your Astrocal API key (create one at https://astrocal.dev/dashboard/connect) | GerekliGizli |
| ASTROCAL_API_URL | Custom API base URL (defaults to https://api.astrocal.dev) | |
| ASTROCAL_DEFAULT_EVENT_TYPE_ID | Default event type ID when not specified in tool calls |
Otomatik kontroller
Çalıştırıldı 12 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirGeçti
- Açık kaynak lisansı (OSI)Geçti
- Son bir yıl içinde commit veya sürüm mevcutGeçti
- Paket adı popüler bir pakete yakın değilGeçti
- Uzak uç nokta HTTPS kullanıyorGeçti
- Yıkıcı araçlar etiketlenmişGeçti
- Modele yönelik gizli talimat yokGeçti
- Pakette veya bağımlılıklarında kritik uyarı yokGeçti
@astrocal/mcp-server
Give your AI agents the power to schedule meetings. The official Model Context Protocol server for Astrocal — the API-first scheduling platform built for developers and AI agents.
Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible client. Your AI assistant can check availability, book meetings, cancel, reschedule, and manage waitlists — all through natural conversation.
Get your API key | Documentation | API Reference
Why Astrocal for AI Agents?
- Purpose-built for AI — Not a Calendly bolt-on. Astrocal's scheduling API was designed from day one for programmatic and AI-agent access.
- 8 tools, zero config — Check availability, book, cancel, reschedule, list event types, manage waitlists. Everything an agent needs.
- Calendar sync built in — Connects to Google Calendar, Microsoft 365, and CalDAV. Your agent books against real availability.
- Payments included — Stripe Connect integration means your agent can book paid consultations, not just free meetings.
- Sandbox mode — Test with
ac_test_*keys. No emails sent, no calendar events created, no charges made.
Quick Start
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"astrocal": {
"command": "npx",
"args": ["-y", "@astrocal/mcp-server"],
"env": {
"ASTROCAL_API_KEY": "ac_live_xxxxxxxxxxxxx"
}
}
}
}
Restart Claude Desktop and the scheduling tools will be available immediately.
Other MCP Clients
Install globally:
npm install -g @astrocal/mcp-server
Run:
ASTROCAL_API_KEY=ac_live_xxx astrocal-mcp
Environment Variables
| Variable | Required | Description |
|---|---|---|
ASTROCAL_API_KEY |
Yes | Your Astrocal API key (get one free) |
ASTROCAL_API_URL |
No | API base URL (default: https://api.astrocal.dev) |
ASTROCAL_DEFAULT_EVENT_TYPE_ID |
No | Default event type ID — your agent won't need to specify it on every call |
Available Tools
check_availability
Check available time slots for booking.
event_type_id(string, optional) — Event type to check. Optional ifASTROCAL_DEFAULT_EVENT_TYPE_IDis set.start_date(string, required) — Start date in ISO 8601 format (e.g.,2026-03-15)end_date(string, required) — End date in ISO 8601 format (e.g.,2026-03-22)timezone(string, optional) — IANA timezone (e.g.,America/New_York). Defaults to UTC.
create_booking
Book a meeting at a specific time.
event_type_id(string, optional) — Event type to book. Optional if default is set.start_time(string, required) — ISO 8601 datetime (e.g.,2026-03-15T14:00:00Z)invitee_name(string, required) — Full name of the person bookinginvitee_email(string, required) — Email address for calendar invitationinvitee_timezone(string, optional) — IANA timezone. Defaults to UTC.notes(string, optional) — Meeting notes (max 1000 characters)
cancel_booking
Cancel an existing booking. The invitee receives a cancellation email automatically.
booking_id(string, required) — ID of the booking to cancelreason(string, optional) — Cancellation reason (max 500 characters)
reschedule_booking
Reschedule a booking to a new time. Check availability first.
booking_id(string, required) — ID of the booking to reschedulenew_start_time(string, required) — New time in ISO 8601 formatreason(string, optional) — Reason for rescheduling (max 500 characters)
list_bookings
List bookings with optional filters.
status(string, optional) — Filter:confirmed,cancelled, orpending_paymentlimit(number, optional) — Max results (default: 10, max: 100)event_type_id(string, optional) — Filter by event type
list_event_types
List available event types that can be booked. No input required.
join_waitlist
Join the waitlist when all slots are full.
event_type_id(string, required) — Event type to join the waitlist forname(string, required) — Full nameemail(string, required) — Email addresspreferred_times(string, optional) — Preferred time ranges or notes
check_waitlist
Check your position on a waitlist.
waitlist_entry_id(string, required) — Waitlist entry ID returned fromjoin_waitlist
Example Conversation
User: "What meetings can I book?"
Agent: calls
list_event_types— "You have two event types: a 30-minute consultation (free) and a 1-hour strategy session ($50)."User: "Check if next Tuesday at 2pm is free for a consultation"
Agent: calls
check_availability— "Tuesday at 2pm is available."User: "Book it for jane@example.com"
Agent: calls
create_booking— "Done! Meeting confirmed for Tuesday, March 17 at 2:00 PM UTC with Jane. A calendar invitation has been sent."User: "Actually, move it to 3pm"
Agent: calls
reschedule_booking— "Rescheduled to 3:00 PM. Jane has been notified."
Part of the Astrocal Platform
This MCP server is one of several ways to integrate with Astrocal:
- REST API — Full scheduling API with OpenAPI 3.1 spec
- React SDK (
@astrocal/react) — Typed hooks, provider, and booking widget for React apps - Embeddable Widget (
@astrocal/widget) — Drop-in booking UI for any website - Dashboard — Manage event types, bookings, team members, and billing
- Webhooks — Real-time notifications for booking events
Create a free account to get started.
Links
License
MIT
Astrocal MCP soruları
Astrocal MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --env 'ASTROCAL_API_KEY=<YOUR_ASTROCAL_API_KEY>' mcp-server -- npx -y @astrocal/mcp-server komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
Astrocal MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Astrocal MCP hangi araçları sunar?
18 araç sunar; bunlar arasında event_type_id, start_date, end_date, timezone, start_time yer alır.
Gerçek rezervasyonlar yapmadan sunucuyu test edebilir miyim?
Evet, e-posta gönderilmediğinden veya ücret alınmadığından emin olmak için test anahtarlarıyla Sandbox modunu kullanabilirsiniz.
Hangi takvimlerle senkronize olur?
Sunucu Google Calendar, Microsoft 365 ve CalDAV ile bağlantı kurar.
Bir toplantı iptal edilirse ne olur?
Davetliye otomatik olarak bir iptal e-postası gönderilir.