Minds Plugin for Claude Code
Connect any database. Create an AI Mind. Ask questions in plain English.
This is a Claude Code plugin marketplace that gives Claude direct access to your data through Minds — no context-switching, no copy-pasting query results, no leaving your terminal.
/plugin marketplace add mindsdb/claude-plugin
/plugin install minds@minds-marketplaceThat's it. Claude can now connect your databases, build Minds, and query your data.
---
What You Can Do
"Connect my Postgres database and tell me which customers churned last month."
Claude will create the datasource, build a Mind, and answer the question — all in one conversation.
Connect Data
Claude connects directly to your databases:
| Engine | | Engine | | Engine | |--------|-|--------|-|--------| | PostgreSQL | | MySQL | | MongoDB | | Snowflake | | BigQuery | | Redshift | | Databricks | | ClickHouse | | SQL Server | | MariaDB | | Elasticsearch | | DynamoDB | | Amazon S3 | | OneDrive | | Teradata |
Create Minds
A Mind is an AI that understands your data. Claude creates them with the right system prompt, connects the right tables, and configures direct SQL access when needed.
Ask Questions
You: "What were our top 10 products by revenue last quarter?"
Claude: [calls ask_mind] → returns the answer with data
You: "Export that as CSV"
Claude: [calls export_query_csv] → gives you the file---
Quick Start
1. Get your API key
Sign up at mdb.ai and grab your API key from the API Keys tab.
2. Set your environment variable
export MINDS_API_KEY=your_key_here3. Install the plugin
/plugin marketplace add mindsdb/claude-plugin
/plugin install minds@minds-marketplace4. Start talking to your data
You: Connect to my postgres database at db.example.com, database "analytics", user "readonly"
You: Create a Mind called "sales-analyst" that can answer questions about our sales data
You: What's the average order value by region for the last 6 months?---
19 Tools
Everything is pure REST — no SDK, no dependencies beyond the MCP server itself.
Datasources
| Tool | What it does | |------|-------------| | list_datasources | List all connected datasources | | get_datasource | Get details + optionally verify connection is alive | | create_datasource | Connect a new database (any of the 15 supported engines) | | update_datasource | Update connection params, description, or table access | | delete_datasource | Remove a datasource |
Minds
| Tool | What it does | |------|-------------| | list_minds | List all Minds | | get_mind | Get a Mind's config, datasources, and parameters | | create_mind | Create a new Mind with datasources and system prompt | | update_mind | Update a Mind's name, datasources, or prompt | | delete_mind | Delete a Mind |
Query
| Tool | What it does | |------|-------------| | ask_mind | Ask a natural language question (Chat Completions API) | | query_mind | Query with conversation context + optional direct SQL (Responses API) |
Results
| Tool | What it does | |------|-------------| | get_query_result | Paginated results from a previous query | | export_query_csv | Export full results as CSV |
Data Catalog
| Tool | What it does | |------|-------------| | get_catalog | Browse tables, columns, types, and statistics | | refresh_catalog | Re-index the schema (missing_only, all, or force) | | load_catalog_tables | Pull specific tables into the catalog | | update_table_description | Annotate a table so the Mind understands it better | | update_column_description | Annotate a column for better query accuracy |
---
Slash Commands
The plugin includes three commands for common workflows:
| Command | Description | |---------|-------------| | /minds:connect | Guided flow to connect a new database | | /minds:ask | Pick a Mind and ask it a question | | /minds:explore | Browse your data catalog — tables, columns, stats |
---
How It Works
┌─────────────┐ stdio ┌─────────────┐ REST ┌─────────────┐
│ │ ◄────────────► │ │ ──────────► │ │
│ Claude Code │ │ MCP Server │ │ Minds API │
│ │ 19 tools │ (Node.js) │ Bearer │ mdb.ai │
└─────────────┘ └─────────────┘ token └──────┬──────┘
│
┌──────▼──────┐
│ Your Data │
│ ┌─────────┐ │
│ │Postgres │ │
│ │Snowflake│ │
│ │BigQuery │ │
│ │ ... │ │
│ └─────────┘ │
└─────────────┘The MCP server is a thin REST wrapper. Every tool maps to a Minds API endpoint. No data is cached, no state is stored — queries go straight to your databases through Minds.
---
Project Structure
├── .claude-plugin/
│ └── marketplace.json # Marketplace catalog
└── plugins/
└── minds/
├── .claude-plugin/
│ └── plugin.json # Plugin manifest
├── .mcp.json # MCP server config
├── package.json
├── src/
│ └── index.mjs # MCP server — 19 tools, pure fetch
├── skills/
│ └── minds-data/
│ └── SKILL.md # Auto-invoked skill for data workflows
└── commands/
├── connect.md # /minds:connect
├── ask.md # /minds:ask
└── explore.md # /minds:explore---
Configuration
| Environment Variable | Default | Description | |---------------------|---------|-------------| | MINDS_API_KEY | (required) | Your Minds API key from mdb.ai/apiKeys | | MINDS_BASE_URL | https://mdb.ai | Custom API base URL (for self-hosted deployments) |
---
For Teams
Add this marketplace to your project's .claude/settings.json so every team member gets it automatically:
{
"extraKnownMarketplaces": {
"minds-marketplace": {
"source": {
"source": "github",
"repo": "mindsdb/claude-plugin"
}
}
},
"enabledPlugins": {
"minds@minds-marketplace": true
}
}---
Contributing
Add a new plugin to the marketplace:
1. Create your plugin in plugins/<your-plugin>/ 2. Add a .claude-plugin/plugin.json manifest 3. Register it in .claude-plugin/marketplace.json 4. Open a PR
---
License
MIT
