> ## 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.

# Claude

> Install the oleander plugin and MCP server in Claude Code and Claude Cowork

## oleander Skills

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

<Card title="OleanderHQ/skills" icon="github" href="https://github.com/OleanderHQ/skills">
  Install query and upload skills for Cursor, Claude Code, and more
</Card>

**Skills CLI:**

```bash theme={null}
npx skills add OleanderHQ/skills -g -y
```

## Claude Code

> Beta: MCP integration docs and workflow may change.

### Plugin

The [oleander Claude Code Plugin](https://github.com/OleanderHQ/claude-plugin) is a convenient way to install the oleander MCP server into Claude Code.

In Claude Code, add this GitHub repository as a marketplace, then install the plugin:

```bash theme={null}
/plugin marketplace add OleanderHQ/claude-plugin
/plugin install oleander@oleander
```

You may need to restart your Claude Code session before the MCP server is available.

### Authenticate

```bash theme={null}
claude mcp login oleander
```

Or run `/mcp`, select **oleander**, and choose **Authenticate**. Your browser opens to complete the OAuth flow.

When authentication succeeds, `claude mcp list` should show `✓ Connected`.

### Manual MCP setup

Alternatively, add the server directly:

```bash theme={null}
claude mcp add --transport http oleander https://oleander.dev/mcp
```

Then authenticate with `claude mcp login oleander` or `/mcp` → **oleander** → **Authenticate**.

### Verify

List configured MCP servers to confirm `oleander` is connected:

```bash theme={null}
claude mcp list
```

### 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 and run the MCP command again:

```bash theme={null}
rm -rf .mcp-auth
```

## 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. Open **Cowork** → **Customize** → **+** → **Add marketplace from GitHub**.
2. Paste `https://github.com/OleanderHQ/claude-plugin` (or `OleanderHQ/claude-plugin`).
3. Install the plugin from the resulting list.

### Scheduled tasks

Use [Cowork scheduled tasks](https://support.claude.com/en/articles/13854387-schedule-recurring-tasks-in-claude-cowork) 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. Open **Organization settings** → **Plugins** → **Add plugin** → **GitHub**.
2. Enter `OleanderHQ/claude-plugin`.
3. Install the plugin for your organization.

### Verify

Ask your agent to confirm it's connected:

> "Are you connected to oleander? Who am I authenticated as?"

The agent should call `oleander_whoami` and return your organization context.