Install Komova in your assistant.

This route is for a managed workspace with plugins enabled. For a personal OpenAI account, follow the Codex route; this guide does not assume your personal account has an admin menu.

1. Your administrator imports the marketplace

1. In workspace administration, open Admin → Plugins → Add → Import marketplace.
2. For Source, paste the repository above. Leave Path empty: the catalog is at the root. Leave Branch empty to use the default branch.
3. Import the marketplace. If OpenAI requests GitHub access for the import, complete this step with your administrator.
4. Review Import results, open Komova and set Installation policy to Available or Installed for the relevant roles. Enable required apps if the platform lists any.

2. Install the plugin in your account

1. Open ChatGPT desktop and choose the relevant workspace.
2. In Plugins Directory, open your workspace tab, find Komova and install it.
3. Authorize the Komova connection and start a new conversation with the plugin enabled.

References: plugin management and using plugins in OpenAI.

This is the local route for using the plugin with a personal OpenAI account. You need the Codex CLI installed and access to Codex in the OpenAI desktop app.

1. In your terminal, add the marketplace with this command:

2. In the OpenAI desktop app, open Codex and Plugins Directory; select the Komova marketplace.
3. Install Komova. If the marketplace does not appear, close and reopen the app.
4. Authorize the Komova connection. Start a new chat and check that the plugin and the komova-work skill are available.

Reference: OpenAI plugin documentation.

Plugins are available on Claude's paid plans, on web, desktop and Cowork.

1. Open Customize → Plugins → Add → Add marketplace → Add from a repository.
2. Paste the marketplace repository and add it.
3. In Discover, find Komova and choose Add.
4. Authorize the connector. In a conversation, open the / menu, find komova-work and check that the connector is enabled.

Reference: Claude's official plugin guide.

Connect your Komova account

Installing the plugin and authorizing your account are separate steps. The first adds the tools and the skill; the second allows access to your data.

1. Open the Komova connection bundled in the plugin and choose connect or authorize.
2. Sign in on the Komova page opened by your assistant. Check the account and requested access before authorizing through OAuth.
3. Return to your assistant and check that the connection is enabled in the conversation.

Enter your credentials only on the sign-in page. Never paste passwords, tokens or OAuth codes into a chat or Form. You can revoke access in Komova.

Start with a read

With the plugin enabled, send this message to check the connection without changing your projects:

If you receive your Projects, reads are connected. Also check that komova-work is available: an MCP connection alone does not confirm that the skill is installed.

If something is missing

I cannot see Plugins or Komova

Check your plan, app version and selected workspace. In a managed workspace, your administrator must import the marketplace and allow the plugin for your account. For a personal OpenAI account, follow Codex. Reopen the app after adding the marketplace.

I installed the plugin, but it cannot read my projects

Check the Komova authorization and that the connector is enabled in this chat. If you added only an MCP URL, install the full plugin to get komova-work too. In ChatGPT, use the desktop app for this package.

The connection asks me to authorize again

Reconnect from your assistant and confirm that you are using the correct Komova account. If it persists, email soporte@komova.app with your assistant, app version and error message, without credentials or codes.

Guide reviewed on October 3, 2026. View the Komova repository.