Documentation Index
Fetch the complete documentation index at: https://docs.timeless.day/llms.txt
Use this file to discover all available pages before exploring further.
The Timeless MCP server lets AI assistants like Claude, Cursor, and other MCP-compatible clients access your meetings, transcripts, rooms, documents, and webhooks directly.
MCP (Model Context Protocol) is an open standard for connecting AI assistants to external data sources. Instead of copying and pasting data, your assistant can query Timeless on your behalf.
Server URL
https://api.timeless.day/mcp/
Authentication
The MCP server uses OAuth 2.1 with PKCE. When you first connect, your MCP client will open a browser window where you sign in with your Google or Microsoft account. After you authorize, the client handles token management automatically.
You do not need an API token to use the MCP server. OAuth handles authentication through your existing Timeless account.
Connecting your client
Claude Desktop
Claude Code
Cursor
Add the following to your Claude Desktop configuration file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"timeless": {
"type": "http",
"url": "https://api.timeless.day/mcp/"
}
}
}
Restart Claude Desktop. You will be prompted to authorize on first use. Run the following command in your terminal:claude mcp add --transport http timeless https://api.timeless.day/mcp/
You will be prompted to authorize on first use. Add the following to your Cursor MCP configuration (.cursor/mcp.json in your project or global settings):{
"mcpServers": {
"timeless": {
"url": "https://api.timeless.day/mcp/"
}
}
}
Restart Cursor. You will be prompted to authorize on first use.
Once connected, your AI assistant can use the following tools:
Meetings
| Tool | Description |
|---|
list_meetings | List meetings with filtering by status, date range, participant, company, and room. Supports expanding related documents. |
get_meeting_transcript | Get a timestamped transcript with speaker labels for a given meeting. |
get_meeting_recording | Get a temporary signed URL to download a meeting recording. |
Rooms
| Tool | Description |
|---|
list_rooms | List rooms with text search. Supports expanding related documents and meetings. |
Documents
| Tool | Description |
|---|
get_document | Get a document in a specific format: markdown, html, raw, docx, or json. |
Webhooks
| Tool | Description |
|---|
list_webhooks | List all webhooks for your account. |
create_webhook | Create a new webhook with a URL and event subscriptions. |
update_webhook | Update a webhook’s URL, events, or enabled status. |
delete_webhook | Delete a webhook. |
Example usage
After connecting, you can ask your assistant questions like:
- “What meetings did I have last week?”
- “Show me the transcript from my meeting with Sarah”
- “Summarize the action items from today’s standup”
- “Create a webhook to notify me when meetings are completed”
The assistant will call the appropriate Timeless tools to answer your questions.