1. Conduid
  2. Cloud
  3. Gudcal Core
MCP server · Cloud

Gudcal Core

by · github.com/gudlab/gudcal-core

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.

Unclaimed NOASSERTION last commit 6 months ago cloud
InstallView source
59Fair

Scored 3 months ago · breakdown

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. It has been installed 0 times through Conduid.

The repository has 1 stars and 0 forks, with the last commit 6 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues (0) before depending on it in production.

Install

Install
npx gudcal-core

This 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

I know everything about Gudcal Core. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ·README presentNot checked yet.
  • ·License declaredNot checked yet.
  • ·Tests presentNot checked yet.
  • ·Dependencies pinnedNot checked yet.
  • ·No dynamic code executionNot checked yet.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

README

Features

  • Agent-First — 18 MCP tools + full REST API for complete autonomous scheduling
  • Smart Scheduling — Event types, availability rules, buffer times, timezone-aware booking pages
  • Calendar Sync — Google Calendar integration with conflict detection and event creation
  • MCP Server — Built-in Model Context Protocol server for AI agent scheduling
  • Teams — Organizations with round-robin and collective scheduling
  • API & Webhooks — REST API with key authentication and real-time booking webhooks
  • Video Conferencing — Auto-generate Zoom and Google Meet links on confirmation
  • Self-Hostable — Deploy on your own infrastructure with full data ownership
  • No Paywalls — All features unlocked. Unlimited event types, bookings, and calendars

Tech Stack

Quick Start

Prerequisites

  • Node.js 20+
  • pnpm
  • PostgreSQL (or use Neon for a free hosted database)

Setup

  1. Clone the repository:
git clone https://github.com/gudlab/gudcal-core.git
cd gudcal-core
  1. Install dependencies:
pnpm install
  1. Copy the environment file and configure it:
cp .env.example .env.local
  1. Set up the database:
pnpm prisma generate
pnpm prisma db push
  1. Start the development server:
pnpm dev

Visit http://localhost:3000 to see GudCal running.

Docker

The fastest way to self-host GudCal.

Using Docker Compose (recommended)

  1. Clone the repo and create your .env file:
git clone https://github.com/gudlab/gudcal-core.git
cd gudcal-core
cp .env.example .env
  1. Set the required secrets in .env:
AUTH_SECRET=$(openssl rand -base64 32)
  1. Start everything:
docker compose up -d

This starts PostgreSQL and GudCal on http://localhost:3000.

Using 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

Environment Variables

Copy .env.example to .env.local and configure:

Variable Required Description
DATABASE_URL Yes PostgreSQL connection string
AUTH_SECRET Yes Random secret for sessions
NEXT_PUBLIC_APP_URL Yes Your deployment URL
GOOGLE_CLIENT_ID Yes Google OAuth client ID
GOOGLE_CLIENT_SECRET Yes Google OAuth client secret
ENCRYPTION_KEY Yes 32-byte hex key for token encryption
RESEND_API_KEY No For email notifications
GOOGLE_CALENDAR_CLIENT_ID No For Google Calendar integration
GOOGLE_CALENDAR_CLIENT_SECRET No For Google Calendar integration

MCP Server

GudCal includes a built-in MCP server that lets AI agents manage scheduling:

  • List event types and availability
  • Create, confirm, and cancel bookings
  • Manage organizations and team members

Connect any MCP-compatible AI client (Claude, GPT, etc.) to GudCal for autonomous scheduling.

Contributing

Contributions are welcome! Here's how to get started:

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/my-feature
  3. Commit your changes: git commit -m "Add my feature"
  4. Push to the branch: git push origin feature/my-feature
  5. Open a pull request

Please open an issue to discuss proposed changes before submitting large pull requests.

License

Business Source License 1.1. See LICENSE.md for details.

You can self-host, modify, and use GudCal freely. The only restriction is offering it as a competing hosted scheduling service. On February 18, 2030, the license automatically converts to Apache 2.0.

README mirrored from the source repository 3 months ago. The original is authoritative.

Questions

About Gudcal Core

How do I install Gudcal Core?

Run npx gudcal-core, then add the server to your MCP client's configuration. Conduid has recorded 0 installs, so the command is known to work with current clients.

Is Gudcal Core safe to use with an AI agent?

Its trust score is 59 out of 100 (fair). It passes 0 of 1 static security checks; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Gudcal Core still maintained?

The last commit was 6 months ago, with 0 open issues. That's long enough that you should check whether the maintainer is responding to issues before depending on it.