> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oleander.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://oleander.dev/account), 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.
>
> <video controls src="https://mintcdn.com/oleander/Ndoc5oxlqQKDkaAS/images/quickstart/claude-coworker-light-add-marketplace.mp4?fit=max&auto=format&n=Ndoc5oxlqQKDkaAS&q=85&s=3e4816b8dbb01e193f9a5afc2b7b9d20" />
>
> Add and install the oleander marketplace in Cowork
>
> **2. Add connector**
>
> Open **Cowork** → **Customize** → **Plugins** → **Oleander** → **Connectors** → **Connect**.
>
> <video controls src="https://mintcdn.com/oleander/Ndoc5oxlqQKDkaAS/images/quickstart/claude-coworker-light-add-connector.mp4?fit=max&auto=format&n=Ndoc5oxlqQKDkaAS&q=85&s=1a81be6ac11758449d694ffcc9a7254c" />
>
> 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](https://docs.oleander.dev/mcp/claude.md#claude-cowork) for scheduled tasks and org-wide rollout.

> [tab] Claude Code
>
> The [oleander Claude Code Plugin](https://github.com/OleanderHQ/claude-plugin) installs the MCP server into Claude Code.
>
> **1. Install Claude Code**
>
> If you haven't already, install the [Claude Code CLI](https://code.claude.com/docs/en/setup) or the [Claude desktop app](https://claude.com/download).
>
> **2. Install the plugin**
>
> In a terminal, run these commands to install the oleander plugin:
>
> ```bash theme={null}
> 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:
>
> ```bash theme={null}
> 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](https://docs.oleander.dev/mcp/claude.md) for skills and manual MCP configuration.

Using a different agent? See [Cursor](https://docs.oleander.dev/mcp/cursor.md), [Codex](https://docs.oleander.dev/mcp/codex.md), and [OpenCode](https://docs.oleander.dev/mcp/opencode.md) 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](https://oleander.dev/app/upload)**: Upload a parquet or CSV file to start querying instantly. No setup needed
* **[Connect your warehouse](https://docs.oleander.dev/connections/bigquery.md)**: For live access to [BigQuery](https://docs.oleander.dev/connections/bigquery.md), [Snowflake](https://docs.oleander.dev/connections/snowflake.md), [Postgres](https://docs.oleander.dev/connections/postgres.md), and Iceberg catalogs, go to [Settings → Lake](https://oleander.dev/app/settings/lake)

To try it quickly, download the [sample Iris dataset](https://raw.githubusercontent.com/OleanderHQ/assets/main/data/iris_dataset.parquet) and upload it at [oleander.dev/app/upload](https://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](https://support.claude.com/en/articles/13854387-schedule-recurring-tasks-in-claude-cowork) 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](https://docs.oleander.dev/connections/bigquery.md)
>
> Query external and lake data through one SQL layer

> [card] [Query Your Lake](https://docs.oleander.dev/platform/compute/duckdb.md)
>
> Upload data and run SQL

> [card] [Setup Your Agent](https://docs.oleander.dev/mcp/introduction.md)
>
> Connect from your editor, terminal, or automation

> [card] [Observability](https://docs.oleander.dev/platform/observability/overview.md)
>
> Lineage, traces, and run history in one place


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.