> For the complete documentation index, see [llms.txt](https://mariadb.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mariadb.com/docs/tools/community/mariadb-ai-plugins/installation.md).

# Installation

Install MariaDB AI Plugins in Claude Code, Codex, OpenCode, Pi, Hermes Agent, or Cursor.

If a harness has its own plugin system, you install MariaDB AI Plugins through it. The installation consists of two steps:

1. Install the plugin into your harness, using the page for your harness below.
2. Configure what the MCP server may access. This step is the same for every harness; see [Configuring the MCP Server](https://mariadb.com/docs/tools/community/mariadb-ai-plugins/configuring-the-mcp-server.md).

The skills are available after the first step. The MCP server rejects all requests until you complete the second step.

{% hint style="info" %}
When the plugin starts for the first time, it downloads and extracts MariaDB Shell, unless a suitable version is already installed. Depending on your network connection, this can take a minute. Later starts use the installed copy.
{% endhint %}

## Prerequisites

* A supported harness: Claude Code, Codex, OpenCode, Pi, Hermes Agent, or Cursor.
* Linux, macOS, or Windows. The optional migration tooling is available on Linux and macOS only.
* Network access on first start, unless MariaDB Shell 26.11.2 or later is already installed.

You don't need a MariaDB Server installation. If you don't have a server, the MCP server can deploy a local [sandbox instance](https://mariadb.com/docs/tools/community/mariadb-ai-plugins/features/sandbox-instances.md).

## Choose Your Harness

{% content-ref url="/pages/sCSPAQl7HwJ3Mcy1av9X" %}
[Claude Code](https://mariadb.com/docs/tools/community/mariadb-ai-plugins/installation/claude-code.md)
{% endcontent-ref %}

{% content-ref url="/pages/hkvsbhJAon9dxeIGoWvi" %}
[Codex](https://mariadb.com/docs/tools/community/mariadb-ai-plugins/installation/codex.md)
{% endcontent-ref %}

{% content-ref url="/pages/CiWw3Qa8EDx2TD28MgZV" %}
[OpenCode](https://mariadb.com/docs/tools/community/mariadb-ai-plugins/installation/opencode.md)
{% endcontent-ref %}

{% content-ref url="/pages/wfIj0EIkzEPMB0kHSxLw" %}
[Pi](https://mariadb.com/docs/tools/community/mariadb-ai-plugins/installation/pi.md)
{% endcontent-ref %}

{% content-ref url="/pages/gGzYGKJNvJ42iK7Q7TRS" %}
[Hermes Agent](https://mariadb.com/docs/tools/community/mariadb-ai-plugins/installation/hermes.md)
{% endcontent-ref %}

{% content-ref url="/pages/AOXcUJ7W5cOfDTjw48ez" %}
[Cursor](https://mariadb.com/docs/tools/community/mariadb-ai-plugins/installation/cursor.md)
{% endcontent-ref %}

## Verify the Skills Are Loaded

To check that the skills are loaded, ask the agent a question that requires MariaDB-specific knowledge, for example:

```
Write a CREATE TABLE for a product catalog, MariaDB style.
```

If the answer uses the native `UUID` data type with `UUID_v7()` rather than `CHAR(36)`, the skills are loaded.

<sub>*This page is licensed: GPLv2*</sub>

{% @marketo/form formId="4316" %}
