← MCP Setup Guide
Plugins & Apps

Maindex plugins for your AI tools

Plugins give you the full Maindex experience: the MCP server plus curated rules, skills, and an Archivist agent that helps you build and maintain your knowledge graph. Pick your platform for installation instructions.

Plugins
Apps

CursorMarketplace pending

Full plugin for the Cursor IDE with MCP server, rules, skill, and agent.

What's included

ComponentDescription
MCP ServerAuto-connects to Maindex via Streamable HTTP with OAuth
Memory ConventionsAlways-on rule: best practices for tagging, canon status, memory kinds, and graph structure
Tool GuidanceOn-demand rule: decision tree for choosing the right Maindex tool
Memory OrganizerSkill: audit your knowledge graph — find duplicates, create links, standardize tags, build collections
The ArchivistAgent: proactively recalls context, stores decisions, and maintains your knowledge graph
1Install from GitHub

The plugin is submitted to the Cursor Marketplace and pending review. In the meantime, install directly from the GitHub repo:

git clone https://github.com/maindexapp/maindex-cursor-plugin.git

Then follow the local install instructions in the repo's README to register the plugin with Cursor.

2Authenticate

On first use, Cursor will prompt you to log in via OAuth. No API key or manual configuration needed.

3Verify

After restarting Cursor, check:

  • Settings → Features → MCP — Maindex server should be listed
  • Settings → Rules — Memory Conventions and Tool Guidance should appear
  • Type /memory-organizer in chat to invoke the skill
  • The Archivist appears as a subagent in the plugin detail view
Marketplace install (coming soon)

Once approved, you'll be able to install directly from the Cursor Marketplace with one click. We'll update these instructions when it's live.

GitHub repository →

Claude CodePending approval

Full plugin for Claude Code with MCP server, commands, skill, and agent.

What's included

ComponentDescription
MCP ServerConnects to Maindex via Streamable HTTP with OAuth
Memory ConventionsCommand (/memory-conventions): best practices for tagging, canon status, memory kinds, and graph structure
Tool GuideCommand (/tool-guide): decision tree for choosing the right Maindex tool
Memory OrganizerSkill (/memory-organizer): audit your knowledge graph — find duplicates, create links, standardize tags, build collections
The ArchivistAgent: proactively recalls context, stores decisions, and maintains your knowledge graph
1Install from GitHub

The plugin is submitted to the Claude Plugin Directory and pending approval. In the meantime, install directly from the GitHub repo and follow the local install instructions in the README.

2Authenticate

On first use, Claude Code will open a browser for you to log in via OAuth. No API key needed.

SSH remote sessions

OAuth requires a local browser. If you're using Claude Code over SSH, create an API key in your dashboard and configure it manually.

3Verify

Check that the plugin is installed and the MCP server is connected:

/plugin list

Then try the commands:

  • /memory-conventions — best-practice guidance
  • /tool-guide — tool selection reference
  • /memory-organizer — audit and organize your knowledge graph
Directory install (coming soon)

Once approved, you'll be able to install directly from the Claude Plugin Directory with one click. We'll update these instructions when it's live.

GitHub repository →

OpenClawNot yet published

Native plugin for OpenClaw with MCP integration, OAuth, skills, and the Archivist.

What's included

ComponentDescription
MCP IntegrationNative Streamable HTTP client connecting to Maindex with OAuth
Memory ConventionsSkill (loaded at startup): best practices for tagging, canon status, memory kinds, and graph structure
Tool GuidanceSkill (loaded at startup): decision tree for choosing the right Maindex tool
Memory OrganizerSkill: audit your knowledge graph — find duplicates, create links, standardize tags, build collections
The ArchivistSkill instructions: proactively recalls context, stores decisions, and maintains your knowledge graph
1Install from GitHub

The plugin is not yet published to a package registry. In the meantime, install directly from the GitHub repo:

git clone https://github.com/maindexapp/openclaw-plugin.git

Then follow the local install instructions in the repo's README to register the plugin with OpenClaw.

2Restart the gateway
openclaw gateway restart
3Authenticate

On first use, a browser window opens for you to log in via OAuth. No API key or manual configuration needed.

Headless / SSH environments

If there's no browser available, switch to API key auth. Create a key in your dashboard and set authMode: "apiKey" in the plugin config.

4Verify

All Maindex tools are registered automatically. The agent's skills are loaded at startup — ask it to search or store memories to confirm.

Package registry install (coming soon)

Once published, you'll be able to install with openclaw plugins install @maindex/openclaw-plugin. We'll update these instructions when it's live.

GitHub repository →

Gemini CLINot yet published

Extension for Gemini CLI (v0.30.0+) with MCP server, context file, and slash commands.

What's included

ComponentDescription
MCP ServerConnects to Maindex via Streamable HTTP with automatic OAuth discovery
Memory ConventionsAlways-on context (GEMINI.md): best practices for tagging, canon status, memory kinds, and graph structure
Tool GuideCommand (/tool-guide): decision tree for choosing the right Maindex tool
Memory OrganizerCommand (/memory-organizer): audit your knowledge graph — find duplicates, create links, standardize tags, build collections
The ArchivistAlways-on behavior (GEMINI.md): proactively recalls context, stores decisions, and maintains your knowledge graph
1Install from GitHub

The extension is not yet published to the Gemini extensions registry. In the meantime, install directly from the GitHub repo:

git clone https://github.com/maindexapp/gemini-plugin.git

Then link the local extension:

gemini extensions link ./gemini-plugin
2Authenticate

On first use, Gemini CLI automatically opens a browser for OAuth login. No API key or manual configuration needed.

Headless / SSH environments

If there's no browser available, create an API key in your dashboard and add it to ~/.gemini/settings.json:

{
  "mcpServers": {
    "maindex": {
      "headers": { "X-API-Key": "your-api-key-here" }
    }
  }
}
3Verify

After restarting Gemini CLI, check that the extension is connected:

/mcp

Then try the commands:

  • /tool-guide — tool selection reference
  • /memory-organizer — audit and organize your knowledge graph
Registry install (coming soon)

Once published, you'll be able to install with gemini extensions install maindexapp/gemini-plugin. We'll update these instructions when it's live.

GitHub repository →

ChatGPTApp pending approval

Maindex app for ChatGPT with MCP connector.

What's included

ComponentDescription
MCP ConnectorConnects ChatGPT to Maindex via Streamable HTTP with OAuth

The ChatGPT app provides the MCP connection. ChatGPT does not support plugins with rules, skills, or agents — but all 12 Maindex MCP tools are available once connected.

1Manual setup (while app is pending)

Until the app is approved, you can connect manually via Developer Mode:

  1. Open Settings → Apps & Connectors → Advanced settings
  2. Toggle Developer Mode on
  3. Click Create under Apps & Connectors
2Configure the connector
FieldValue
Connector URLhttps://maindex.io/mcp
NameMaindex
DescriptionLong-term memory for AI agents

ChatGPT handles OAuth automatically — you'll be prompted to log in when you first use the connector.

3Enable in conversations

In any chat, toggle the Maindex connector on in the compose area to give ChatGPT access to your memories.

App store install (coming soon)

Once approved, you'll be able to install Maindex directly from the ChatGPT app store. We'll update these instructions when it's live.

OpenAI MCP documentation →
Other platforms

Maindex works with any MCP client via the raw MCP server URL. See the MCP Setup Guide for step-by-step instructions for Windsurf, Gemini CLI, LM Studio, Open WebUI, Msty, and more.