Skip to main content

oleander Skills

Query and upload workflows for agents live in the public skills pack:

OleanderHQ/skills

Install query and upload skills for Cursor, Claude Code, and more
Skills CLI:

Claude Code

Beta: MCP integration docs and workflow may change.

Set up the plugin

The oleander Claude Code Plugin is a convenient way to install the oleander 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:
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:
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.
5

Start using oleander tools

Claude Code can query your lake, upload files, schedule reports, and inspect query runs, lineage, and cost. For example:
  • “Show me the columns and a few sample rows from one of my tables.”
  • “Why did my last query fail?”
  • “Which engine ran my last query, and why was it slow?”
See what the oleander MCP can do for more tools and example prompts.

Manual MCP setup

If you’d rather not use the plugin, add the server directly.
1

Add the server

In a terminal, run:
2

Authenticate

In a regular terminal (not the IDE extension), run:
Select the oleander server, then Authenticate to begin the authentication flow.
3

Verify the connection

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

Reset authentication

Claude Code caches the OAuth access token and refresh token in .mcp-auth. If you want to authenticate with a different org, remove the cached tokens, then run /mcp → oleander → Authenticate again inside Claude Code:

Claude Cowork

Beta: Plugin and Cowork integration docs may change.
Install the oleander plugin in Claude Cowork to give your team access to lake queries, uploads, and pipeline context without manual MCP configuration.
1

Add the plugin marketplace

Open Cowork → Customize → + → Add marketplace from GitHub, then paste https://github.com/OleanderHQ/claude-plugin (or OleanderHQ/claude-plugin).
2

Install the plugin

Install the oleander plugin from the resulting list.
3

Connect

Open Cowork → Customize → Plugins → Oleander → Connectors → Connect, then complete sign-in in your browser.
4

Verify the connection

Ask Claude:
“Are you connected to oleander? Call identity_get and tell me which organization I’m authenticated with.”
Claude should return the organization you signed in to.

Scheduled tasks

Use Cowork scheduled tasks to run oleander queries on a cadence. Type /schedule in a Cowork task, or create one from the Scheduled page in the sidebar.

Org-wide rollout

To make the plugin available across your organization:
1

Add the plugin

Open Organization settings → Plugins → Add plugin → GitHub, then enter OleanderHQ/claude-plugin.
2

Install for your organization

Install the plugin for your organization.