oleander

Quickstart

Connect an agent to oleander, upload or connect your data, and ask your first question in minutes.

We'll connect your agent, authenticate, and ask your first question.

[!NOTE]

No account yet? Sign up at oleander.dev, or let your agent create one when it signs in during Step 1.

Step 1: Connect Your Agent

Use the oleander plugin in Claude to query your data, upload files, or schedule daily reports.

[tab] Claude Cowork

1. Add plugin marketplace

Open Cowork → Customize → + → Add marketplace from GitHub.

Paste https://github.com/OleanderHQ/claude-plugin (or OleanderHQ/claude-plugin), then install the oleander plugin.

Add and install the oleander marketplace in Cowork

2. Add connector

Open Cowork → Customize → Plugins → Oleander → Connectors → Connect.

Add oleander connector in Cowork

3. Verify the connection

Ask your agent for a quick connection check:

"Are you connected to oleander?"

The agent should call identity_get and return your organization context.

[!TIP]

See Claude Cowork setup for scheduled tasks and org-wide rollout.

[tab] Claude Code

The oleander Claude Code Plugin installs the MCP server into Claude Code.

1. Install Claude Code

If you haven't already, install the Claude Code CLI or the Claude desktop app.

2. Install the plugin

In a terminal, run these commands to install the oleander plugin:

claude plugin marketplace add OleanderHQ/claude-plugin
claude plugin install oleander@oleander

If Claude Code is already running, restart it so the plugin loads.

3. Authenticate

After installing the plugin, you need to authenticate. In a regular terminal (not the IDE extension), run:

claude /mcp

Select the oleander server, then Authenticate to begin the authentication flow. Complete sign-in in your browser. Signing in creates a free oleander account if you don't have one.

4. Verify the connection

To verify the connection, ask Claude Code to list your oleander catalogs.

[!TIP]

See Claude setup for skills and manual MCP configuration.

Using a different agent? See Cursor, Codex, and OpenCode setup.

Step 2: Connect Your Data

Connect or upload at least one data source so you can start a conversation about it with your agent:

• Upload a file: Upload a parquet or CSV file to start querying instantly. No setup needed
• Connect your warehouse: For live access to BigQuery, Snowflake, Postgres, and Iceberg catalogs, go to Settings → Lake

To try it quickly, download the sample Iris dataset and upload it at oleander.dev/app/upload.

Step 3: Ask Your Question

Ask your agent in plain English. Through oleander's MCP server it can list catalogs, run SQL, upload files, and schedule reports.

• Analytics: "What's the average petal length in default.iris, broken down by species?"
• Exploratory: "Explore the iris dataset. What looks unusual across species?"

Once you're comfortable asking questions, try going further:

• Schedule a daily report with a Cowork scheduled task every morning at 8 a.m. (cron: 0 8 * * *).
• Ask for weekly context on what's new or changed in your data, like tables renamed, updated, or newly uploaded.
• Run a weekly org wrap on cost trajectory and whether you're on track for the month's KPIs.

[!TIP]

Ask in plain English. oleander handles the query plan and execution behind the scenes so your agent can focus on the answer.

Take It Further

[card] Connect Your Warehouse

Query external and lake data through one SQL layer

[card] Query Your Lake

Upload data and run SQL

[card] Setup Your Agent

Connect from your editor, terminal, or automation

[card] Observability

Lineage, traces, and run history in one place

This documentation is built and hosted on Mintlify, a developer documentation platform.