Connect an MCP Server to Kotae.ai

We recommend using Activepieces as an MCP server. It’s free to start and the UX is simpler than other MCP server (e.g., n8n)

What you’ll need

• Kotae.ai workspace with access to Developer → MCP
• An Activepieces account (free plan works!)

For the specific example flow below, you will also need

• A Google account with Calendar access

Part 1 — Build the MCP tool in Activepieces

1) Create a new Flow

1. In Activepieces, click New flow. You can choose to create from scratch or use a template provided by Activepices
2. Alternatively, get a headstart with template from Kotae
• Shared template of booking meeting on Google Calendar
  https://cloud.activepieces.com/templates/kQ8qDuJcrJuUuDk43pGuJ
• Template will cover Part 1 — Build the MCP tool in Activepieces
• You will still have to complete Part 2 — Connect the MCP server in Kotae and Part 3 — End-to-end test separately in Kotae workspace
3. Name the work flow e.g. Demo call guide.
4. For Step 1, choose MCP Tool (v0.x).
• Name: Book a demo
• Description: Tool used to book or schedule a call with business owner
• Parameters: Add the inputs your chatbot will pass in. A simple, robust set:
• attendee_name (string, required)
• attendee_email (string, required)
• start_iso (string, required)
• end_iso (string, required)
• timezone (string, required, e.g. JST)

2) Add the Google Calendar step

3. Step 2 → add Google Calendar → Create Event.
• Connect your Google account (one-time).
• Calendar: pick the calendar where meeting invitation should land.
• Summary/Title: Demo call with {{step_1.attendee_name}}
• Start: {{step_1.start_iso}}
• End: {{step_1.end_iso}}
• Guests/Attendees: {{step_1.attendee_email}}
• Description:
  Optinal, can be left blank or note:
  
  Requested by: {{step_1.attendee_name}} ({{step_1.attendee_email}})
  Timezone: {{step_1.timezone}}
• Send Notifications: yes, to everyone
• Toggle off the rest of settings

3) Return a reply to the MCP client

4. Step 3 → add MCP → Reply to MCP Client and craft the payload that the chatbot will see. A simple JSON result:
   {
   "status": "success",
   "message": "Booked! Calendar invite sent to {{step_1.attendee_email}}.",
   "event": {
   "id": "{{step_2.id}}",
   "htmlLink": "{{step_2.htmlLink}}",
   "start": "{{step_2.start}}",
   "end": "{{step_2.end}}"
   }
   }
   

4) Test and publish

5. Click Test on the flow. Use sample values (e.g., start_iso: 2025-09-12T15:00:00-07:00, end_iso: 2025-09-12T15:30:00-07:00).
6. When it looks good, click Publish.
7. Copy the MCP Server URL (from the MCP Tool card / flow publish panel) and note the Auth header / API key shown for that endpoint. You’ll paste these into Kotae.

Part 2 — Connect the MCP server in Kotae

5) Open the MCP settings

1. In Kotae dashboard go to Developer → MCP.
2. Click Add MCP server (opens a modal).
3. Fill in:
• Name: Activepieces – Book a demo
• Event Type: Chatbot
  (This is the internal event name Kotae will use when calling your tool.)

6) Paste the MCP JSON configuration

4. Get Server URL
1. Project > MCP
2. Select MCP server from the list
3. Connect > Other
   Copy the URL
5. Use the JSON config below (replace placeholders with your actual Server URL from Activepieces):
   {
   "mcpServers": {
   "Activepieces": {
   "url": "[replace]"
   }
   }
   }
   Click Save.

Part 3 — End-to-end test

6. Open your website/chat and say:
   “I’d like a meeting on Sep 12 at 3pm JST. My email is nicha@example.com.”
7. Kotae triggers Event Type: Chatbot and sends:
   {
   "attendee_name": "Nicha",
   "attendee_email": "nicha@example.com",
   "start_iso": "2025-09-12T15:00:00-07:00",
   "end_iso": "2025-09-12T15:30:00-07:00",
   "timezone": "JST",
   }
8. Activepieces creates the Calendar event and replies with the JSON from Reply to MCP Client.
9. Kotae shows the visitor a friendly confirmation, e.g.:
   “All set for Sep 12, 3:00–3:30 PM PT. I emailed you a calendar invite.”