About Cursor DB MCP
Cursor DB MCP is an MCP server published by jbdamask in the Developer Tools category: model Context Protocol server for querying Cursor chat history.
The repository has 26 stars and 5 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/jbdamask/cursor-db-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (2)
query_tableQuery a specific table in a project's database
Parameters not published.
refresh_databasesRefresh the list of database paths
Parameters not published.
Ask AI
Ask AI about Cursor DB MCP
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 6 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- ✓Tests presentA test suite exists in the repository.
- !Dependencies pinnedNo lockfile. Installs can pull different code over time.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
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
README fetched from the repository 6 days ago. The original is authoritative.