Quickstart
Enable the gateway, make your first call, and connect an AI assistant.
Requires the Agent API
This documents Meetily's Agent API, an opt-in local feature. It needs a Pro license and is off by default. The gateway is loopback-only unless you explicitly open it to your LAN.
1. Turn on Integrations
Open Settings, then Integrations, and switch it on. This needs a Pro license, and it's off by default. Restart Meetily to apply the change.
2. Your token
On the same machine, the CLI and Python SDK read the local token automatically. You do not need to find it or copy it anywhere.
If you're calling the API with curl instead, you'll need the token in an environment variable. See Authentication and scopes for where the token file lives and how to load it.
3. First call
Check that the gateway is alive. GET /health needs no token:
curl -s http://127.0.0.1:8420/healthThen confirm who you are. GET /v1/whoami returns your token id, its scopes, and your license tier:
curl -s http://127.0.0.1:8420/v1/whoami -H "Authorization: Bearer $MEETILY_PRO_TOKEN"meetily-pro whoami --jsonfrom meetily_agent import MeetilyClient
print(MeetilyClient().system.whoami())4. Do something real
List your meetings, then read a summary.
curl -s "http://127.0.0.1:8420/v1/meetings?limit=5" -H "Authorization: Bearer $MEETILY_PRO_TOKEN"
curl -s http://127.0.0.1:8420/v1/meetings/MEETING_ID/summary -H "Authorization: Bearer $MEETILY_PRO_TOKEN"5. Connect an AI assistant (optional)
Install the MCP server so an AI assistant like Claude Code can call Meetily directly:
meetily-pro mcp installThen restart your AI client to pick up the new MCP server. This is a second restart, separate from the one in step 1.
This is the least-privilege path
meetily-pro mcp install mints a scoped, per-client token (Read plus Record by default; add --write for write access) rather than handing your AI client the admin token. The Integrations panel in the app is an alternative that can additionally grant Delete. See Limitations and roadmap for details.
Two restarts
There are two separate restart points here: Meetily itself after you turn on Integrations in step 1, and your AI client after you install the MCP server in step 5. Skipping either leaves the old state in effect.
6. Where next
Last updated on
