Connect Codex

About 2 minutes. You need a Sharedrop account.

Install the CLI

In your terminal, run:

npm install -g @sharedrop/cli

This needs Node.js 20.10 or later.

sharedrop login

A browser window opens once. Approve the sign-in, then check it with sharedrop whoami. It shows your Sharedrop username.

Add the skill

npx skills add ShareDropCloud/skills --skill sharedrop -g

The skill teaches Codex when and how to use the CLI. Codex reads it from ~/.agents/skills.

Try it

Ask Codex:

Make a one-page summary of this conversation and share it with ShareDrop.

Check it worked

Codex replies with a sharedrop.cloud link that opens your new page, private to you until you share it.

If it doesn't work

The terminal says command not found: close and reopen the terminal. If it still fails, run node --version and update Node.js if it is older than 20.10.
sharedrop whoami does not show your username: run sharedrop login again.
Codex answers without a link: start a new session so it picks up the skill, or say "use the sharedrop CLI" in your request.

Other way: add Sharedrop as a connector

Use this only if you can't install the CLI. The connector signs you in through the browser, so you don't need an API key.

Add the connector:

codex mcp add sharedrop --url https://sharedrop.cloud/api/mcp

For your whole team, commit a .codex/config.toml file to the repository with this entry. Codex reads it in trusted projects, and each teammate runs codex mcp login sharedrop to sign in with their own account.

[mcp_servers.sharedrop]
url = "https://sharedrop.cloud/api/mcp"

See Connector (MCP) for more, or the CLI Guide for every command.

Last checked against OpenAI's docs on 12 Oct 2026.

On this page