list_conversations
Retrieve and filter Cursor chat history by project, date range, or keywords. Use conversation IDs for detailed analysis with AI-generated summaries.
Instructions
Lists Cursor chats with summaries, titles, and metadata ordered by recency. HIGHLY RECOMMENDED: Use projectPath parameter to filter conversations by specific project/codebase - this dramatically improves relevance by finding conversations that actually worked on files in that project. Returns conversation IDs for use with get_conversation tool. WORKFLOW TIP: Start with projectPath filtering for project-specific analysis, then call get_conversation with specific IDs from results. Includes AI-generated summaries by default. Supports date range filtering (YYYY-MM-DD format).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| endDate | No | End date for filtering (YYYY-MM-DD). Note: Timestamps may be unreliable. | |
| filePattern | No | Filter conversations mentioning files matching this pattern (e.g., "*.tsx") | |
| hasCodeBlocks | No | Filter to conversations that contain code blocks | |
| includeAiSummaries | No | Include AI-generated conversation summaries | |
| includeEmpty | No | Include conversations with no messages | |
| includeRelevanceScore | No | Include relevance scores when filtering by projectPath | |
| keywords | No | Filter conversations containing any of these exact keywords (literal text matching) | |
| limit | No | Maximum number of conversations to return (1-100) | |
| minLength | No | Minimum conversation length in characters to include | |
| outputMode | No | Output format: "json" for formatted JSON (default), "compact-json" for minified JSON | json |
| projectPath | No | **RECOMMENDED** Filter conversations by project/codebase name (e.g., "my-app") or full path (e.g., "/Users/name/Projects/my-app"). This finds conversations that actually worked on files in that project, dramatically improving relevance for project-specific analysis. | |
| relevantFiles | No | Filter conversations that reference any of these specific files | |
| startDate | No | Start date for filtering (YYYY-MM-DD). Note: Timestamps may be unreliable. |