Cursor DB MCP Server
A Model Context Protocol (MCP) server for accessing Cursor IDE’s SQLite databases. This server allows AI assistants to explore and interact with Cursor’s project data, chat history, and composer information.
Cursor
Prerequisites
Cursor IDE
Installation
Easy Installation
Use the provided installation script to install all dependencies:
python install.py
This script will install:
- Basic MCP server and dependencies
Using with Cursor IDE
- Open Cursor and navigate to Settings->Cursor Settings->MCP.
- Click: Add new MCP server
- Name: Cursor DB MCP; Type: Command
- Command: <fully qualified path to>uv run --with mcp[cli] mcp run <fully qualified path to>/cursor-db-mcp-server.py
Now you can ask questions about the database or retrieve info about historical chats.
Using with Claude Desktop
Installing MCP servers for Claude Desktop
Add this to your claude_desktop_config.json file
"cursor-db-mcp": {
"command": "<fully qualified path to >/uv",
"args": [
"run",
"--with",
"mcp[cli]",
"mcp",
"run",
"<fully qualified path to >/cursor-db-mcp-server.py"
]
}
Available Resources
cursor://projects
- List all available Cursor projectscursor://projects/detailed
- List projects with detailed informationcursor://projects/{project_name}/chat
- Get chat data for a specific projectcursor://projects/{project_name}/composers
- Get composer IDs for a specific projectcursor://composers/{composer_id}
- Get data for a specific composer
Available Tools
query_table
- Query a specific table in a project’s databaserefresh_databases
- Refresh the list of database paths
How It Works
The server scans your Cursor installation directory to find project databases (state.vscdb files). It then exposes these databases through MCP resources and tools, allowing AI assistants to query and analyze the data.
Notes
- Cursor stores AI conversations in different places. Increasingly, chats are stored as “composerData” under globalStorage/state.vscdb. If you don’t get results when asking about chats for recent projects, try asking for composers.
- This was written on a Mac. YMMV with other OS
Shameless Plug

Like this? Try Cursor Journal to create DevLogs directly from Cursor chat history!
License
MIT
Cursor DB MCP Server
Project Details
- jbdamask/cursor-db-mcp
- Other
- Last Updated: 4/18/2025
Categories
Recomended MCP Servers
A Model Context Protocol (MCP) server that integrates with Google's Gemini Pro model, can be used in Claude...
Socket based MCP Server for Ghidra
MCP Server for Metasploit
This project provides a dedicated MCP (Model Context Protocol) server that wraps the @google/genai SDK. It exposes Google's...
CCXT MCP Server bridges the gap between AI models and cryptocurrency trading by providing a standardized interface through...
A Model Context Protocol (MCP) server implementation connecting Claude Desktop with DeepSeek's language models (R1/V3)
A Python-based MCP for use in exposing Notion functionality to LLMs (Claude)
MCP server for Unreal Engine 5
MCP server for Directus API integration
MCP (Model Context Protocol) for Microsoft 365. Includes support for Microsoft Graph and other services