Tinylawn MCP server
Technical setup and tool reference for developers and compatible AI clients.
Add the hosted server to your client
Your client must support remote Streamable HTTP servers and browser-based OAuth. Add the complete endpoint below, then sign in to Tinylawn and choose one organization.
https://app.gettinylawn.com/mcp Common client configuration
{
"mcpServers": {
"tinylawn": {
"url": "https://app.gettinylawn.com/mcp"
}
}
}Client schemas vary. Use your client’s current documentation if its format differs. Do not add a Zapier API key or organization identifier to this configuration.
Authorization stays organization-scoped
The OAuth grant is tied to the Tinylawn user and organization selected during approval. Membership is checked again when the grant is used.
list_calls
Lists calls newest first from the authorized organization. Results include archived, spam, and missed calls and are returned as pages rather than an account-wide total.
limit
Optional integer from 1 to 50. Defaults to 20.
cursor
Opaque nextCursor from the preceding response. Omit it for the newest calls.
- id
- Unique call identifier
- occurredAt
- Call time in ISO 8601 format
- durationSeconds
- Call duration when available
- category
- Saved call classification
- summary
- Saved summary, or null when unavailable
- unread
- Whether the call is currently unread
- archived
- Whether the call is archived
- url
- Direct link to the call in Tinylawn
When nextCursor is not null, pass it unchanged as cursor to retrieve the next page.
A narrow read surface—not the calls API
The server returns only call metadata, saved summaries, state flags, and a Tinylawn link. It does not expose transcripts, recordings, phone numbers, contacts, intake details, provider identifiers, billing data, or organization settings.
Cannot edit, archive, or mark calls read
Cannot send messages or create bookings
Cannot read recordings or transcripts
Cannot confirm jobs or appointments
Saved summaries may contain personal information supplied by callers. Treat returned summaries as customer data and follow your AI client’s retention and access policies.
Revoke a connection in Tinylawn
Open Tinylawn Settings → Integrations → MCP, find the client and organization, and select Disconnect. Removing a server from a client alone may not revoke its Tinylawn grant.
Diagnose the connection
The client has no remote MCP option
Confirm it supports remote Streamable HTTP servers.
Authorization does not open
Allow browser pop-ups, then restart the connection.
Authorization is denied
Confirm the signed-in user belongs to the selected Tinylawn organization.
The cursor is invalid
Call list_calls again without a cursor.
Access stopped working
The grant may have been revoked or organization membership may have changed. Reconnect and approve access again.
Need more detail? Read the full Help Center article or email support@gettinylawn.com without including tokens or caller information.