AI 에이전트가 일정 확인, 예약, 취소 및 회의 일정 변경을 포함한 스케줄링 작업을 관리할 수 있도록 지원합니다.
다른 이름 astrocal-dev/mcp-server, mcp-server, @astrocal/mcp-server
- 스타
- 1
- Tools
- 18
- 다운로드, 30일
- 220
- 최신 버전
- 0.1.6
- 마지막 커밋
- 2026년 10월 10일
- 라이선스
- MIT
Astrocal MCP란?
AI 에이전트가 일정 확인, 예약, 취소 및 회의 일정 변경을 포함한 스케줄링 작업을 관리할 수 있도록 지원합니다. 18개 도구를 제공합니다. 예: event_type_id, start_date, end_date.
프로젝트 README에서 생성된 요약
Astrocal MCP server 정보
Astrocal은 AI 에이전트가 자연스러운 대화를 통해 복잡한 스케줄링 워크플로우를 처리할 수 있는 특화된 인터페이스를 제공합니다. 이 MCP server를 사용하면 Claude Desktop, Cursor, Windsurf와 같은 클라이언트가 Astrocal 스케줄링 플랫폼과 직접 상호작용할 수 있습니다. 에이전트는 일정 확인, 회의 예약, 예약 취소, 대기 명단 관리 등 8가지의 고유한 작업을 수행할 수 있습니다. Google Calendar, Microsoft 365, CalDAV와 연결되므로 에이전트는 항상 실시간 가용성을 바탕으로 동작합니다.
개발자는 npx를 사용하거나 npm을 통해 패키지를 전역으로 설치하여 로컬 환경에 설정할 수 있습니다. 통합을 위해서는 ASTROCAL_API_KEY가 필요하며, 개발 중 실제 이메일이나 캘린더 이벤트가 생성되는 것을 방지하기 위해 테스트 키와 함께 sandbox 모드를 활용할 수 있습니다. 또한 Stripe Connect 연동을 통해 유료 상담을 지원하므로, 에이전트가 스케줄링과 함께 트랜잭션까지 관리할 수 있습니다. 사용자는 환경 변수에 기본 이벤트 유형 ID를 설정하여 경험을 더욱 맞춤화할 수 있습니다.
활용 사례
- 1가능한 시간대 확인특정 날짜 범위 내에서 특정 이벤트 유형에 대해 가능한 시간을 에이전트에게 찾아달라고 요청합니다.
- 2회의 예약 자동화사용자의 이름과 이메일을 제공하여 어시스턴트가 상담 예약을 진행하도록 합니다.
- 3기존 예약 수정에이전트에게 예정된 회의를 다른 시간으로 변경하도록 요청합니다.
- 4예약 대기 명단 관리모든 슬롯이 가득 찼을 때 에이전트가 특정 인원을 대기 명단에 추가하도록 지시합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Astrocal MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Astrocal MCP 설치
$ claude mcp add --env 'ASTROCAL_API_KEY=<YOUR_ASTROCAL_API_KEY>' mcp-server -- npx -y @astrocal/mcp-serverCursor에 Astrocal MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@astrocal/mcp-server"
],
"env": {
"ASTROCAL_API_KEY": "<YOUR_ASTROCAL_API_KEY>"
}
}
}
}VS Code에 Astrocal MCP 설치
.vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@astrocal/mcp-server"
],
"env": {
"ASTROCAL_API_KEY": "<YOUR_ASTROCAL_API_KEY>"
}
}
}
}VS Code CLI에 Astrocal MCP 설치
$ code --add-mcp '{"name":"mcp-server","type":"stdio","command":"npx","args":["-y","@astrocal/mcp-server"],"env":{"ASTROCAL_API_KEY":"<YOUR_ASTROCAL_API_KEY>"}}'Claude Desktop에 Astrocal MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@astrocal/mcp-server"
],
"env": {
"ASTROCAL_API_KEY": "<YOUR_ASTROCAL_API_KEY>"
}
}
}
}Codex에 Astrocal MCP 설치
$ codex mcp add mcp-server --env 'ASTROCAL_API_KEY=<YOUR_ASTROCAL_API_KEY>' -- npx -y @astrocal/mcp-serverCodex config.toml에 Astrocal MCP 설치
~/.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>"
Gemini CLI에 Astrocal MCP 설치
$ gemini mcp add -s user -e 'ASTROCAL_API_KEY=<YOUR_ASTROCAL_API_KEY>' mcp-server npx -- -y @astrocal/mcp-serverGemini settings.json에 Astrocal MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@astrocal/mcp-server"
],
"env": {
"ASTROCAL_API_KEY": "<YOUR_ASTROCAL_API_KEY>"
}
}
}
}Astrocal MCP 도구 18
README에서 감지됨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개 모두 보기도구 수 줄이기
statuslimitnameemailpreferred_timeswaitlist_entry_id
| status | — | |
| limit | — | |
| name | — | |
| — | ||
| preferred_times | — | |
| waitlist_entry_id | — |
구성
ASTROCAL_API_KEY필수비밀Your 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
| 이름 | 설명 | 유형 |
|---|---|---|
| ASTROCAL_API_KEY | Your Astrocal API key (create one at https://astrocal.dev/dashboard/connect) | 필수비밀 |
| 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 |
자동 검사
2026년 11월 12일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능통과
- 오픈 소스 라이선스 (OSI)통과
- 최근 1년 내 커밋 또는 릴리스통과
- 패키지 이름이 인기 패키지와 유사하지 않음통과
- 원격 엔드포인트가 HTTPS 사용통과
- 파괴적인 도구에 라벨 표시됨통과
- 모델에 대한 숨겨진 지침 없음통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음통과
README
GitHub에서 보기@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 질문
Astrocal MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'ASTROCAL_API_KEY=<YOUR_ASTROCAL_API_KEY>' mcp-server -- npx -y @astrocal/mcp-server를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Astrocal MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
Astrocal MCP는 어떤 도구를 제공하나요?
18개 도구를 제공합니다. 예: event_type_id, start_date, end_date, timezone, start_time.
실제 예약 없이 서버를 테스트할 수 있나요?
네, Sandbox 모드와 테스트 키를 사용하면 이메일 발송이나 결제 없이 테스트할 수 있습니다.
어떤 캘린더와 동기화되나요?
이 MCP server는 Google Calendar, Microsoft 365, CalDAV와 연결됩니다.
회의가 취소되면 어떻게 되나요?
초대 대상자에게 취소 이메일이 자동으로 발송됩니다.