AI agents

MCP server

Calendeur speaks the Model Context Protocol, so AI assistants and agents can check availability, book and reschedule meetings, read contacts and add meeting notes in plain language. Tools run on the same engine and permissions as the REST API.

Endpoint

Streamable HTTP (recommended)

https://calendeur.com/api/mcp

Authentication header

Authorization: Bearer mcp_live_...

Use an API key from Settings → API keys. The agent only sees tools its key's scopes allow.

Connect a client

// Settings → Developer → Edit config (claude_desktop_config.json)
{
  "mcpServers": {
    "calendeur": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://calendeur.com/api/mcp",
        "--header", "Authorization:${AUTH_HEADER}"
      ],
      "env": { "AUTH_HEADER": "Bearer mcp_live_..." }
    }
  }
}

Use a dedicated key for agents

Give an agent's key only the scopes it needs. An assistant that only answers questions about your schedule needs read:bookings, not execute:bookings.

Things to ask

"What's free on my calendar on Thursday afternoon?"

"Book a 30-minute intro with alex@example.com at the first open slot next week."

"Move my 3pm with Alex to tomorrow at the same time."

"Here are my notes from today's call with Northwind: ... Add them to the booking."

"Who booked with me this week, and which of them are new leads?"

Tools (17)

calendeur_list_event_types

List all active booking event types with duration, slug, direct booking URL, and settings.

read:bookings

calendeur_get_availability

Calculate open meeting time slots for a given event type or username across a specific date range and timezone.

read:bookings

calendeur_book_meeting

Book a meeting for a guest at a time returned by calendeur_get_availability. Runs the same checks as the booking page (working hours, conflicts, booking rules), syncs the host calendar, creates the meeting link and emails the invite.

execute:bookings

calendeur_reschedule_meeting

Reschedule an existing booking to a new time slot.

execute:bookings

calendeur_cancel_meeting

Cancel an existing booking with a stated reason.

execute:bookings

calendeur_search_contacts

Search customer CRM contacts by name, email, company, or tags, including past call summaries and booking histories.

read:contacts

calendeur_trigger_voice_call

Initiate an autonomous AI Voice outbound phone call to a prospect or client with dynamic memory and objection playbook.

execute:voice_calls

calendeur_get_call_details

Retrieve full transcript, summary, sentiment analysis, audio latency, and recording for a voice call.

read:analytics

calendeur_get_analytics_telemetry

Retrieve real-time platform analytics (booking counts, conversion rate, voice call durations, answer rate, and closed revenue).

read:analytics

calendeur_get_contact_dossier

Retrieve full 360-degree CRM dossier for a contact (lead score, meeting transcripts, voice call histories, and AI strategic talking points).

read:bookings

calendeur_list_deals

List all active commercial sales opportunities grouped across pipeline stages (Inbound, Discovery, Proposal, Negotiation, Won, Lost) with revenue values.

read:bookings

calendeur_update_deal_stage

Move a sales deal across the Kanban pipeline stages and update the booking outcome.

execute:bookings

calendeur_get_booking

Get one booking: guest, time, status, join link, notes and AI meeting summary.

read:bookings

calendeur_list_bookings

List bookings, newest first, optionally filtered by status, guest email or date range.

read:bookings

calendeur_add_meeting_notes

Attach notes or a transcript from a meeting held anywhere (phone, Zoom, Meet, in person) to a booking. Calendeur writes an AI digest, marks the meeting completed and queues follow-ups (recap email, CRM update).

execute:bookings

calendeur_list_routing_forms

List routing forms with their questions (id, label, type, required, choices) so they can be submitted with calendeur_submit_routing_form.

read:routing

calendeur_submit_routing_form

Submit answers to a routing form. Rules, CRM capture and follow-up actions run as on the hosted form; returns where the person was routed and a booking link when relevant.

execute:routing

PreviousWebhooks