# Appointlet MCP

> Appointlet connects your scheduling workspace to any AI agent. It lets you manage the entire meeting lifecycle—from listing team availability and retrieving client intake answers to canceling a booked slot. You can audit entire organizations, view all available booking links across multiple pages, and pull detailed history on specific appointments, everything through natural language prompts.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** appointment-booking, meeting-management, availability-sync, client-intake, scheduling-automation, event-coordination

## Description

Forget logging into your scheduling platform just to check who's free or what the next meeting is about. This MCP lets you talk to your calendar system using plain English. Your agent accesses Appointlet data to handle all booking logistics for you. Need to know if a team member can meet? Ask and get a list of available people. Want to see what answers an attendee gave in their pre-call form? Get those details instantly. When you connect this MCP via Vinkius, your virtual agent handles the whole process—managing appointments and pulling scheduling data without you jumping through tabs or copying links. You just ask for it.

## Tools

### list_scheduling_pages
Lists all available unique scheduling pages across the entire organization.

### get_scheduling_page
Gets detailed information about a single booking page, including its unique URL.

### list_meeting_types
Lists all different meeting formats configured for a scheduling page.

### get_meeting_type
Gets configuration details for a particular style of meeting (e.g., 30-min call).

### list_bookings
Lists all scheduled meetings for a given scheduling page; useful for reporting.

### get_booking
Retrieves all details for one specific, single booking.

### cancel_booking
Cancels an existing appointment and sends a notification email to the attendee.

### list_members
Lists every team member assigned to the booking page, useful for checking round-robin workload.

### get_organization
Retrieves the overall profile and status for your entire Appointlet account.

### list_intake_fields
Returns the names, types, and required status of custom client intake form fields.

## Prompt Examples

**Prompt:** 
```
List the meeting types on my primary scheduling page.
```

**Response:** 
```
Found 3 meeting types for the page. '30-Min Tech Call' (30m, Zoom, Active). '15-Min Screening' (15m, Phone, Hidden). '1-Hour Strategy' (60m, Google Meet, Active). Should I pull the latest bookings for the Tech Call?
```

**Prompt:** 
```
Cancel my meeting with Alex Johnson scheduled for today and give the reason 'Flight delayed'.
```

**Response:** 
```
Booking bk_298w (Meeting with Alex Johnson) has been successfully canceled. The reason 'Flight delayed' was attached, and the invitee has received an automated email. The 14:00 time slot is now open again.
```

**Prompt:** 
```
What answers did the attendee give in the intake form for booking bk_71m?
```

**Response:** 
```
For booking bk_71m (Acme Corp Discovery), the attendee listed 'Company Size' as '50-100 employees', 'Primary Challenge' as 'Slow CI/CD pipelines', and 'Tech Stack' as 'NextJS and Vercel'. They selected the 'Yes' checkbox for possessing spending authority.
```

## Capabilities

### Get Booking Details
Retrieve all specific information about a single, existing meeting.

### Handle Bookings and Cancellations
Look up appointments or cancel them immediately after giving the reason.

### Review Client Intake Data
Pull all answers an attendee provided in their initial booking form.

### Check Team Availability
List every team member assigned to a page so you can audit who's working on what.

### Manage Scheduling Pages
Get configurations for all booking links and the overall organization status.

## Use Cases

### Client needs pre-call data review
An Account Manager needs to prepare for a call. Instead of finding the booking link, opening the appointment, and manually copying fields, they prompt their agent: 'What answers did the attendee give in the intake form for booking bk_71m?'. The agent runs the required tool and returns specific data points like 'Company Size' or 'Primary Challenge'.

### Team needs workload audit
A Support Leader notices a single team member is booked solid. They ask their agent to list all available members on the page, running `list_members`. This instantly shows who has capacity and balances the load.

### Emergency booking cancellation
A consultant's flight gets delayed, forcing a meeting cancellation. They prompt the agent to 'Cancel my meeting with Alex Johnson scheduled for today and give the reason 'Flight delayed'.' The agent uses `cancel_booking` and sends the required automated email.

### Need general booking report
A team lead needs a list of all meetings booked last month. They ask their agent to use `list_bookings`, getting a clean, consolidated view for reporting without needing to export data from the web interface.

## Benefits

- Check client intake answers fast. Instead of manually opening booking details, the agent uses `list_intake_fields` to pull specific responses for your upcoming calls.
- Audit team workloads easily. Use `list_members` to see who's assigned to which scheduling page so you can manage round-robin assignments without checking multiple dashboards.
- Handle cancellations in one go. You can use the `cancel_booking` tool to remove an appointment and notify both parties immediately.
- Get a full picture of your setup. The agent uses `list_scheduling_pages` and `get_organization` to map out all available booking links across your entire account structure.
- Keep track of meetings. You can run `list_bookings` to get a clean report of everything scheduled on a page for CRM syncing.

## How It Works

The bottom line is you tell your agent what you need, and it handles the connection to Appointlet automatically.

1. Subscribe to this MCP and plug in your Appointlet API key.
2. Your AI client connects, giving it access to read scheduling data and execute actions against your booking links.
3. You prompt your agent with a request—like 'List all bookings for next week'—and the system executes the necessary calls.

## Frequently Asked Questions

**How do I find out what my team can book?**
You run `list_members`. This command lists all staff assigned to the page, helping you audit who is available and managing round-robin workloads.

**Can I get a list of all booking links?**
Yes. Use `list_scheduling_pages` to retrieve every unique booking link configured across your entire Appointlet organization.

**How do I view client data from past meetings?**
You can use `list_bookings` for a report of all scheduled items, or if you know the ID, use `get_booking` to get full details on one specific meeting.

**What is the purpose of the cancel_booking tool?**
The `cancel_booking` function removes an appointment and ensures the attendee receives a notification email. The time slot also becomes available for new bookings immediately.

**How do I use `get_organization` to check my Appointlet workspace tier and connected members?**
The function returns the top-level profile details for your entire organization. This is useful for auditing your current subscription status or seeing which team members are linked across all scheduling pages.

**Before creating a form, how do I use `list_intake_fields` to see what custom fields are available for an Appointlet meeting type?**
It returns the names, data types, and required status of all customizable intake form fields. You must run this tool first when mapping incoming client data into your agent's record creation process.

**If I need to audit every available booking format, should I use `list_meeting_types`, and how do I check the details with `get_meeting_type`?**
Use `list_meeting_types` first to see all configured formats on a page. You then run `get_meeting_type` using a specific ID to pull detailed settings, like duration or required conferencing tools.

**For generating comprehensive reports and syncing with a CRM, how does the `list_bookings` tool function?**
This method retrieves all booking records associated with an entire scheduling page. It's designed for reporting purposes or when you need to sync your full list of appointments into an external system.

**Can the AI agent cancel an upcoming meeting on my behalf?**
Yes. Provide the booking ID (which you can ask the agent to find) and the cancellation reason. The agent triggers the exact routine in Appointlet to withdraw the booking and safely releases the block on your calendar while notifying the invitee.

**I need attendee form answers before a call. Can the agent get them?**
Absolutely. Using the `get_booking` and `list_bookings` capabilities, your AI agent surfaces the raw intake form fields filled out by attendees when booking their time. It's an instant method to read out context without switching screens.

**Can I edit the schedule of round-robin assignees using the agent?**
No. The MCP server is optimized as an observability, lookup, and action-oriented companion. It reads the organizational hierarchy, list members, and checks statuses, but modifying overarching structural logic requires entering the Appointlet dashboard.