MCP Tools Reference

Give your AI real tools

Track meals, manage todos, search memories, create calendar events, and more.
Connect Mio's MCP server to any compatible client — 22 tools across 5 categories.

Quick start

Three steps to connect Mio to your AI client.

Get your API key

Go to mio.fyi/account and copy your Mio API key.

Add to your client

Paste the config into Claude, ChatGPT, n8n, or any MCP-compatible client. See setup instructions below.

Start asking

“Log my lunch”, “What's on my calendar?”, “Search my memories for...” — your AI now has real tools.

Claude Code (CLI)

Bearer token

One command. Replace YOUR_MIO_API_KEY with your key from mio.fyi/account.

bash

claude mcp add mio --transport streamable-http https://mcp.mio.fyi -- --header "Authorization: Bearer YOUR_MIO_API_KEY"

Claude Desktop

Bearer token

Add to your claude_desktop_config.json:

json

{
  "mcpServers": {
    "mio": {
      "transport": "streamable-http",
      "url": "https://mcp.mio.fyi",
      "headers": {
        "Authorization": "Bearer YOUR_MIO_API_KEY"
      }
    }
  }
}

Claude Web (claude.ai)

OAuth — no API key needed

Add Mio as a Connector in Claude's settings. Authenticates via your Mio account — no API key required.

OAuth handled by WorkOS AuthKit. Your credentials are never shared.

ChatGPT

OAuth — no API key needed

Add Mio as an App in ChatGPT settings. Authenticates via your Mio account — no API key needed.

OAuth connection — your credentials stay secure.

n8n / Other Clients

Bearer token

Any MCP-compatible client that supports Streamable HTTP transport:

Endpointhttps://mcp.mio.fyi

TransportStreamable HTTP

AuthBearer token — your Mio API key

Get your API key from mio.fyi/account

Tool reference

22 tools across 5 categories — all scoped to your account. Copy-paste this section into your AI client's context for full awareness.

Skills

Your Personal Data Vault

Mio stores your data in "skills" — personal databases only you can access. Two types: tabular skills for structured data (calories, todos, workouts) and vector skills for text content with semantic search (memories, journal entries, recipes).

Tabular Skills

Structured data with SQL-like queries

create_tabular_skillCreate a new structured data skill with typed columns

add_tabular_itemAdd a record to a tabular skill

get_tabular_itemsQuery with filters, sorting, aggregations

update_tabular_itemsUpdate records by ID or condition

alter_tabular_skill_schemaAdd or modify columns on an existing skill

Vector Skills

Text content with semantic search

create_vector_skillCreate a new semantic search skill with metadata fields

add_vector_itemAdd text content with category and tags

search_vectorsFind content by meaning, not just keywords

Skill Management

list_skillsDiscover all your existing skills

get_skillGet full schema and usage instructions for a skill

update_skill_instructionsUpdate a skill's description, notes, or examples

share_skillShare a skill with another Mio user by email

Always call list_skills first to see what's available, then get_skill(skill_name) before writing data to learn the schema.

Web Access

Search & Scrape

Give your AI access to the live web — search Google and read any URL.

search_webGoogle search — up to 10 results with titles, URLs, and snippets

read_web_pageScrape any URL — returns content as markdown, plain text, or HTML

Google Calendar

Full CRUD

Full create, read, update, delete on your primary Google Calendar. Requires a connected Google account.

create_google_calendar_eventCreate events with title, time, location, attendees, timezone

list_google_calendar_eventsList events for a date range (defaults to next 7 days)

update_google_calendar_eventModify any event field by ID

delete_google_calendar_eventRemove an event by ID

Connect your Google account at mio.fyi/account

Proactive Actions

Scheduled Automations

Set up recurring tasks that run automatically and deliver results via email, SMS, or WhatsApp.

create_proactive_actionSchedule a recurring action (daily summaries, reminders, analyses)

list_proactive_actionsView all your scheduled actions

update_proactive_actionChange schedule, instructions, delivery channel, or enable/disable

"Send me a daily email at 9am summarizing my todos and calendar for the day"

Discovery

Explore Available Tools

Not sure what's available? Start here.

list_available_toolsList all 22 tools with their descriptions

Start here if you're not sure what's available.

What you can ask

Once Mio is connected, try any of these with your AI client.

“

Log that I had a chicken salad for lunch, about 350 calories

“

What did I eat this week? Show me total calories by day

“

Add 'buy groceries' to my todos

“

Search my memories for anything about my trip to Japan

“

Create a calendar event for dentist appointment tomorrow at 2pm

“

What's on my calendar this week?

“

Save this recipe for pasta carbonara to my recipes skill

“

Show me my weight trend for the last month

“

Send me a daily email at 9am summarizing my todos and calendar

“

Search the web for the best restaurants in Brooklyn

Authentication & privacy

Account-scoped data

All data is scoped to your account. You can only access your own skills, calendar, and email. No cross-account access.

Two auth methods

OAuth for Claude Web (Connectors) and ChatGPT (Apps) — click to connect, no keys to manage.
API Key for Claude Code, n8n, and other clients — get yours at mio.fyi/account.

Google integration

Google Calendar requires a connected Google account. Connect at mio.fyi/account.

Data you own

Your skills live in your private Arca vault — files in S3 you can export or delete at any time.

22 tools. One connection.

Give your AI client real tools for your personal data.

Get Started Get API Key