Connect your data to Windsurf

Give Windsurf's Cascade AI access to your databases — query data without leaving your editor.

What Windsurf can do with Sequel

Cascade with real data access

Windsurf's Cascade agent can now include database queries in its multi-step workflows. Ask it to check your schema, pull production data, and use it to guide code generation — all in one flow.

Data-informed development

Stop context-switching to a SQL client when you need to understand your data. Ask Cascade to query your database directly and use the results to write more accurate code and migrations.

Python analysis alongside your code

When you need statistical analysis or visualizations, Cascade can run Python through Sequel's sandbox — pandas, matplotlib, seaborn — and show results inline in the editor.

Example prompts

Everything you can ask Windsurf about your data.

Ask in plain English. Sequel turns it into a query, runs it read-only, and Windsurf hands back the answer. No SQL, no dashboards, no CSV exports.

Connect Windsurf

What you can ask Windsurf

What's the shape of our `users` table — columns, types, constraints?
Show me 10 example rows from the `transactions` table
How many orders were placed in the last 24 hours?
Which columns in our database have high NULL rates?
Generate a migration to add an index on `orders.created_at`

Setup

Add Sequel to Windsurf

Drop the Sequel MCP server into Windsurf, then ask it anything about your connected data. Sequel is read-only by default and shows each query before it runs.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "sequel": {
      "serverUrl": "https://api.sequel.sh/mcp",
      "headers": {
        "Authorization": "Bearer sql_your_api_key"
      }
    }
  }
}

Sequel CLI

Install Sequel MCP to Windsurf

The Sequel CLI installs Sequel into Windsurf in one step — it signs you in, provisions a scoped API key, and writes the right config to the right place. No keys to copy by hand.

Prefer npm? npm install -g @sequelsh/cli@latest works too.

1
Install the Sequel CLI
One line installs the latest CLI with whatever package manager you have.
```
curl -fsSL https://sequel.sh/install | sh
```
2
Sign in
Authenticate in your browser and pick an organization.
```
sequel login
```
3
Install into Windsurf
One command installs Sequel into Windsurf and writes its MCP config.
```
sequel install windsurf
```

Data sources

Connect any source to Windsurf

PostgreSQL

Query your PostgreSQL database in plain English. No SQL required.

MySQL

Instant insights from your MySQL database. Ask in plain English.

ClickHouse

Real-time analytics on ClickHouse at any scale, in plain English.

BigQuery

Query petabytes of BigQuery data in plain English.

Google Sheets

Query, write, and manage Google Sheets with AI.

Google Analytics 4

Ask your GA4 data anything. No SQL, no dashboards.

Google Search Console

Unlock your SEO data with natural language. No exports, no pivot tables.

MCP Server

Connect any MCP-compatible server and query it with AI in seconds.

Stripe

Ask your Stripe data anything. MRR, churn, refunds — answered in plain English.

PostHog

Ask your PostHog product data anything — with HogQL under the hood.

Mixpanel

Conversational analytics on your Mixpanel events, funnels, and retention.

Amplitude

Query your Amplitude taxonomy, funnels, and dashboards in plain English.

HubSpot

Your AI analyst for HubSpot — contacts, deals, tickets, and pipelines.

Ahrefs

Ask your Ahrefs SEO data anything — backlinks, keywords, and traffic.

Apollo.io

Ask your Apollo.io prospects, contacts, and accounts anything — in plain English.

Explore other AI agents

Claude

Use Claude to query your databases, explore schemas, and build analyses — all from one conversation.

Cursor

Query your databases and explore schemas without leaving your code editor.

ChatGPT

Connect ChatGPT to your databases and get data-backed answers in every conversation.

VS Code

Get database access inside VS Code Copilot without leaving your editor.

Zed

Connect Zed's AI assistant to your databases for real-time data access while you code.

Gemini

Connect Google Gemini to your databases for grounded, data-backed answers.

Claude Code

Query your databases directly from the Claude Code CLI — without leaving your terminal.

Codex

Give OpenAI Codex CLI real-time database access for data-grounded coding sessions.

OpenClaw

Turn your self-hosted OpenClaw agent into a data analyst that queries every source you've connected.

Hermes

Give Nous Research's Hermes agent read access to every database and marketing tool you've connected.

Frequently asked questions

Where does the Windsurf MCP config file go?

Place your MCP configuration at ~/.codeium/windsurf/mcp_config.json. Use the `serverUrl` key (not `url`) as shown in the config above — Windsurf uses a slightly different field name than other clients.

Does this work with both Cascade and Windsurf Chat?

Yes. Sequel tools are available in both Windsurf Chat (single-turn) and Cascade (multi-step agentic flows). Cascade is especially powerful because it can chain multiple Sequel tool calls together.

How do I verify Sequel is connected in Windsurf?

Open Windsurf settings and navigate to the MCP section. You should see 'sequel' listed as a connected server with a green status indicator. If it's red, check that your API key is correct and the URL is reachable.

Can my whole team use this setup?

Each team member should have their own Sequel API key (create them in Settings → API Keys). The MCP config file is personal (in the home directory), so each developer configures it independently.

Put your data inside Windsurf

Connect in minutes — then ask across all your data, not just one source.

Get started free View all integrations