Apptoto MCP Server

Connect your Apptoto account to Claude, ChatGPT, Codex, or Gemini so you can manage appointments, contacts, and replies just by chatting.

A few examples of what you can ask once you've connected:

  • "Read recent replies from appointments in Apptoto and tell me which ones I need to respond to."
  • "Reply to Fred with, 'That works, thanks.'"
  • "Who was a no-show last week? Have they scheduled a new appointment since?"

Server endpoint (paste this anywhere a client asks for an MCP URL):

https://api.apptoto.com/mcp

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI assistants talk to outside services on your behalf. When you connect Apptoto, the assistant gets a set of tools it can call -- but only after you sign in to Apptoto and approve which scopes it gets. Your password and API keys never leave Apptoto; the assistant only sees the access token you grant.

Add Apptoto to your assistant

CLIClaude Code

Run this in your terminal:

claude mcp add --transport http apptoto https://api.apptoto.com/mcp

Claude Code will open a browser, you'll sign in to Apptoto, approve the requested scopes, and the connection is live in any future session.

WebClaude.ai

Settings → Connectors → Add custom connector → paste https://api.apptoto.com/mcp.

Claude will redirect you to Apptoto to sign in and approve. After that, ask something like "What Apptoto events do I have tomorrow?" to test it.

WebChatGPT

ChatGPT now connects to MCP servers as Apps. Until Apptoto's app is published in the ChatGPT directory, you'll need to add it as a custom developer app:

  • Business, Enterprise, or Edu workspaces: a workspace owner must enable Developer mode under Settings → Connectors → Advanced before anyone can add a custom app.
  • Plus / Pro accounts: turn on Developer mode from Settings → Apps & Connectors → Advanced.

Then in any chat, open the + menu → Apps & Connectors → Create, paste https://api.apptoto.com/mcp, give it a name, and approve the OAuth sign-in.

Full instructions from OpenAI: Apps in ChatGPT.

CLICodex CLI

Add an entry to ~/.codex/config.toml:

[mcp_servers.apptoto]
url = "https://api.apptoto.com/mcp"

Then run codex mcp login apptoto in your terminal to authorize. Codex will open a browser to sign in to Apptoto and approve the scopes before you start a session.

CLIGemini CLI

Run this in your terminal:

gemini mcp add --transport http apptoto https://api.apptoto.com/mcp

Or add it by hand to ~/.gemini/settings.json: 

{
  "mcpServers": {
    "apptoto": { "httpUrl": "https://api.apptoto.com/mcp" }
  }
}

Launch Gemini and run /mcp auth apptoto to sign in and approve scopes.

Heads up: the assistant can only see and change what your user account can see and change. You can revoke its access any time from Settings → Connected Applications inside Apptoto.

For developers

The server is OAuth 2.1 with Dynamic Client Registration (RFC 7591). Discovery documents live at:

  • /.well-known/oauth-protected-resource
  • /.well-known/oauth-authorization-server
  • /.well-known/mcp/server-card.json

Full API reference: apidocs.apptoto.com.

Available tools

Once connected, the assistant can call any of these tools (subject to the scopes you approve). Tools marked WRITE create, change, or send something on your account.

  • cancel_participant_auto_messageWrite

    Un-queues one of a participant's automated reminder messages so it will not send at its configured time.

  • check_availability

    Finds open appointment slots on a booking page for a date range, respecting working hours, buffers, and existing calendar conflicts.

  • create_bookingWrite

    Books an appointment on a booking page at a chosen time, just as a customer would through your scheduling page.

  • create_contact

    Adds a new contact to one of your address books.

  • create_event

    Adds a new event to one of your connected calendars.

  • delete_contactWrite

    Permanently removes a contact from an address book.

  • delete_eventWrite

    Permanently removes an event from a connected calendar and cancels its reminders.

  • get_contact

    Looks up the details of a single contact.

  • get_event

    Looks up a single event, including its participants and scheduled reminders.

  • get_userinfo

    Confirms which Apptoto account is connected.

  • list_address_books

    Lists the address books (contact sources) connected to your account.

  • list_booking_pages

    Lists your booking pages, including their public links, appointment types, and required fields.

  • list_bookings

    Lists appointments people self-scheduled through your booking pages over a date range.

  • list_calendars

    Lists the calendars connected to your account.

  • list_contacts

    Searches and lists contacts across your address books.

  • list_conversation_messages

    Shows the individual messages within a single conversation.

  • list_conversation_templates

    Lists the approved message templates you can use to start a conversation.

  • list_conversations

    Lists your text, email, and call conversations by folder (inbox, outbox, archived, and more).

  • list_events

    Lists your calendar events over a date range.

  • list_participant_auto_messages

    Lists the automated reminder messages that apply to a participant, including when each would fire and whether it is queued.

  • mark_participant

    Marks an event's participants with a status such as confirmed, cancelled, or no-show.

  • provide_feedback

    Lets the assistant send the Apptoto team a note when something you asked for is not supported yet.

  • reply_to_conversationWrite

    Sends a reply on an existing text or email conversation.

  • schedule_participant_auto_messageWrite

    Queues one of a participant's automated reminder messages to send automatically at its configured time.

  • send_participant_auto_messageWrite

    Immediately sends one of a participant's automated reminder messages (the "send now" action).

  • start_conversationWrite

    Notifies the people on an appointment (or any contact) by sending a text, email, or voice call from an approved template.

  • tag

    Adds or removes a tag on an event, participant, or contact.

  • update_contact

    Updates an existing contact's details, phone numbers, and email addresses.

  • update_event

    Updates the details of an existing calendar event.