# Apptoto MCP MCP

> Apptoto lets your AI agent manage client scheduling and automated communication. It connects directly to your booking system so you can orchestrate reminders, access detailed appointment information, and review all sent SMS or email messages using natural language commands.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** appointment-reminders, sms-notifications, no-show-reduction, automated-scheduling, client-communication, calendar-sync

## Description

Managing a service business means juggling appointments, contacts, and reminder logs—it's a massive amount of manual tracking. This MCP lets your AI client handle that coordination entirely. You tell your agent what you need, and it accesses everything from listing all connected calendars to pulling the full history of messages sent to specific clients. Need to know if John Doe got his confirmation SMS? Your agent checks the detailed message logs for you. Want a quick list of everyone booked next week? Done. It treats your entire booking lifecycle like one single conversation. You just plug this into Vinkius and connect it to your preferred AI client, turning what used to be tedious dashboard clicking into simple chat commands.

## Tools

### get_appointment
Retrieves the detailed information for a single specific appointment time slot.

### list_address_books
Lists all available address books connected to your account, helping you find the right client group.

### list_appointments
Shows a comprehensive list of appointments within a specified date range.

### list_calendars
Lists all connected calendar sources to give you an overview of your scheduling sources.

### list_contacts
Finds and lists client profiles within a designated address book ID.

### list_messages
Retrieves a log of recent text messages or emails sent to clients.

## Prompt Examples

**Prompt:** 
```
List all my upcoming appointments for today in Apptoto.
```

**Response:** 
```
I've retrieved your schedule for today. You currently have 5 appointments, including a 'Technical Consultation' at 2 PM and 4 other sessions. Would you like the detailed high-fidelity metadata for any of these?
```

**Prompt:** 
```
Show the recent SMS reminders sent to my clients.
```

**Response:** 
```
Accessing message logs... I found 10 recent SMS reminders successfully sent today. Highlights include confirmation messages to @user1 and @user2. Need the high-fidelity delivery timestamps?
```

**Prompt:** 
```
List the contacts in address book ID '1024'.
```

**Response:** 
```
Retrieving contacts... I found 50 synced profiles in address book 1024. Your most active client is John Doe (ID: cont_789). Shall I retrieve his full high-fidelity profile for you?
```

## Capabilities

### Reviewing the full schedule
List all upcoming or past appointments across every calendar you use.

### Managing client records
Access and manage synced contact profiles from your connected address books.

### Auditing communications history
Pull detailed logs for all SMS or email reminders sent to clients.

### Getting specific booking details
Retrieve the full information for a single, specified appointment.

### Monitoring calendar connectivity
List and verify all connected calendars to ensure your schedule is accounted for.

## Use Cases

### Checking for a specific client's status
A provider needs to know if they sent the follow-up reminder last Tuesday. They ask their agent, and it uses `list_messages` to retrieve the log, confirming the exact delivery time and content.

### Preparing for a team meeting
An office manager needs to show the board all appointments booked for next quarter. They tell their agent to run a query using `list_appointments` with the required date range, instantly generating the data set.

### Onboarding a new service line
A developer needs to build an internal tool that checks client records. They use `list_address_books` first, then `list_contacts`, pulling all necessary synced profiles into their code logic.

### Verifying scheduling sources
The practitioner opens a new laptop and needs to confirm every connected calendar is active. They simply ask the agent to use `list_calendars` for an immediate, reliable overview.

## Benefits

- Stop wasting time checking logs. You can ask for a summary of all sent reminders using the `list_messages` tool, instantly showing if confirmations went out via SMS or email.
- Need to check next month's availability? Use `list_appointments` to pull a full list of bookings within any date range with one command.
- Client data management gets simple. By using `list_address_books` and then `list_contacts`, you can locate and review client profiles without clicking through multiple tabs.
- Detailed schedule oversight is automatic. You can call `get_appointment` to get deep info on a single booking, including who it's with and when it runs.
- Calendar visibility means no gaps. Your agent uses `list_calendars` to give you an overview of every place your schedule lives, ensuring nothing falls through the cracks.

## How It Works

The bottom line is that you never have to manually check reminder logs or dig through fragmented contact lists again.

1. First, subscribe to this MCP on Vinkius.
2. Next, grab your API Key and Secret from the Apptoto dashboard settings.
3. Finally, start giving commands through your AI client; it handles the rest by calling the necessary tools.

## Frequently Asked Questions

**How do I check a client's schedule using the Apptoto MCP?**
You use `list_appointments` and specify the date range. This tool retrieves all bookings, allowing you to see what's coming up without checking each calendar separately.

**Can I find a specific client by name using Apptoto MCP?**
Yes. You first run `list_address_books` to confirm the location, and then use `list_contacts` with that ID to pull all synced profiles.

**Is there an easy way to see if I sent a reminder?**
Absolutely. Use `list_messages`. This tool pulls detailed logs for SMS and email, letting you verify the delivery status of client communication at a glance.

**What if I only want details on one meeting? Do I use get_appointment?**
Yes. `get_appointment` is designed exactly for that. You give it the specific booking ID, and you get all the detailed information in a single response.

**When I use `list_address_books`, how does the MCP help me identify which directory holds client data for a specific region?**
The system lists all connected directories and their unique IDs. You must provide the ID you want to query, preventing the AI agent from pulling contact records from an old or secondary address book.

**If I run `list_calendars` and one of my connected scheduling platforms is temporarily down, how does the MCP handle that error?**
The MCP handles failures gracefully. It will report a specific error for the failing calendar without stopping your entire request. You get clear feedback on which service needs fixing.

**When I use `list_contacts`, how can I ensure that the profile information is current and reflects any changes made today?**
The MCP pulls high-fidelity, real-time metadata. It ensures your agent works with data reflecting immediate updates across all integrated scheduling platforms.

**How do I narrow down results when using `list_messages` to see only SMS reminders and exclude email communications?**
You must pass specific filters that detail the communication type. This allows you to pinpoint exact outreach methods without wading through mixed media logs.

**How do I find my Apptoto API Key and Secret?**
Log in to your account, navigate to **Settings** > **Advanced** > **API**, and generate or copy your unique credentials.

**Can I list my connected address books via AI?**
Yes! The `list_address_books` tool allows your agent to retrieve all contact directories currently synced with your Apptoto account.

**How do I check sent reminder messages?**
Use the `list_messages` tool to retrieve high-fidelity historical records of all SMS and email communications dispatched programmatically.