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
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?”
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.