About Gudcal Core
Gudcal Core is an MCP server published by gudlab in the Cloud category: schedule Smarter in the AI Agent Era Open-source scheduling infrastructure with MCP server, team scheduling, and smart availability. Self-host or use our cloud.
The repository has 6 stars and 5 forks, with the last commit 28 days ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/gudlab/gudcal-coreThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Gudcal Core
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 19 hours ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
If this is useful, star this repo — it is the source-available edition. Issues and OSS PRs belong here, not on the private SaaS copy.
Why GudCal
- Agent-first — 21 MCP tools plus a REST API so an AI agent can run scheduling after you create one API key
- Calendly-simple — event types, availability, buffers, timezone-aware public booking pages
- Calendar sync — Google Calendar conflict detection and event creation
- Teams — organizations with round-robin and collective scheduling (Team plan on cloud)
- Self-host or cloud — Docker / Vercel, or use gudcal.com
Cloud plans
| Free | Pro ($12/mo) | Team ($20/mo) | |
|---|---|---|---|
| Event types | 3 | 20 | Unlimited |
| Calendar connections | 1 | 5 | Unlimited |
| Bookings | Unlimited | Unlimited | Unlimited |
| Analytics / custom domains | — | Yes | Yes |
| Organizations + hosted MCP | — | — | Yes |
Self-hosting (NEXT_PUBLIC_IS_SELF_HOSTED=true) removes hosted plan caps on core scheduling for your org. BSL 1.1 does not allow offering GudCal as a competing hosted Calendly. Hosted MCP on gudcal.com stays Team.
Quick start
git clone https://github.com/gudlab/gudcal-core.git
cd gudcal-core
pnpm install
cp .env.example .env.local
pnpm prisma generate
pnpm prisma db push
pnpm dev
See Self-Hosting for Docker and production.
Docker
Docker Compose (recommended)
git clone https://github.com/gudlab/gudcal-core.git
cd gudcal-core
cp .env.example .env
# set AUTH_SECRET and other required secrets in .env
docker compose up -d
GudCal listens on http://localhost:3000.
Docker directly
docker build -t gudcal .
docker run -p 3000:3000 \
-e DATABASE_URL="postgres://..." \
-e AUTH_SECRET="..." \
-e NEXT_PUBLIC_APP_URL="http://localhost:3000" \
gudcal
MCP
Point any MCP-compatible client at https://gudcal.com/api/mcp (Cloud Team) or at /api/mcp on your self-host.
- Docs: gudcal.com/docs/mcp
- Registry manifest:
server.json(this public repo, not the private SaaS copy) - Cursor / Open Plugins:
.mcp.json
{
"mcpServers": {
"gudcal": {
"url": "https://gudcal.com/api/mcp"
}
}
}
License
Business Source License 1.1. You can self-host for your own org. You cannot offer GudCal as a competing hosted scheduling service. Change date: 18 Feb 2030 → Apache 2.0.
Contributing
Please read CONTRIBUTING.md. Bug reports and small docs PRs are the fastest path in. Private → public sync is a documented script: ./scripts/sync-oss.sh.
README fetched from the repository 19 hours ago. The original is authoritative.