skills.rest
mims-harvard
mims-harvardOFFICIAL
Explore all skills by this author →
Website𝕏@marinkazitnikGitHub

tooluniverse-codex-plugin

Installs, updates, and troubleshoots the ToolUniverse plugin on OpenAI Codex.

1.7k|254|Updated Mar 3, 2025
Search Tags:#Troubleshooting#Marketplace#ToolUniverse#UVX#plugin installation#openai codex#MCP Server
One-click install
npx skills add https://github.com/mims-harvard/ToolUniverse --skill tooluniverse-codex-plugin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tooluniverse-codex-plugin
Source: https://github.com/mims-harvard/ToolUniverse/tree/main/plugins/tooluniverse/skills/tooluniverse-codex-plugin
Command: npx skills add https://github.com/mims-harvard/ToolUniverse --skill tooluniverse-codex-plugin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Setting up the ToolUniverse plugin on OpenAI Codex involves easy-to-mistake details: the exact marketplace name, the two-command install flow, startup auto-upgrade behavior, the uvx-based MCP server, and API key environment variables. This Skill provides the authoritative procedure so the plugin installs and runs correctly the first time.

Core Features & Use Cases

  • Guided Installation: Registers the mims-harvard/ToolUniverse marketplace and installs the plugin with two codex CLI commands, then verifies via codex plugin list.
  • Update & Version Management: Explains Codex's startup auto-upgrade for Git marketplaces, on-demand marketplace upgrades, uvx cache clearing, and pinning a specific tooluniverse PyPI version for reproducibility.
  • Diagnosis & Repair: Provides an idempotent seven-step diagnostic script covering missing uvx, MCP server startup failures, shadowing global installs, and stale tool versions.
  • Use Case: A user says the Codex plugin shows no tools after install; the Skill walks through restarting Codex, sanity-checking uvx tooluniverse in a terminal, and clearing the uv cache.

Quick Start

Read the tooluniverse-codex-plugin skill and install the ToolUniverse plugin on my Codex setup, then verify it works.

Frequently Asked Questions about tooluniverse-codex-plugin

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install the ToolUniverse plugin on OpenAI Codex?▼

Run codex plugin marketplace add mims-harvard/ToolUniverse, then codex plugin add tooluniverse -m tooluniverse, and restart Codex. The MCP server auto-starts via uvx tooluniverse on first use, taking about 30 seconds for the initial package download.

How do I update the ToolUniverse Codex plugin to the latest version?▼

Codex auto-upgrades Git marketplaces on startup, so a new version arrives on your next launch. To refresh immediately, run codex plugin marketplace upgrade tooluniverse, and clear stale tools with uv cache clean tooluniverse.

Why does the Codex plugin show no tools after installation?▼

The first launch downloads the tooluniverse package, which takes about 30 seconds, so restart Codex and wait. If tools still do not appear, run uvx tooluniverse in a terminal to check whether uv and the MCP server work outside Codex.

Can I pin a specific ToolUniverse version in Codex for reproducibility?▼

Yes, edit the installed plugin's .mcp.json under ~/.codex/plugins/cache/ and set the args to [email protected] or any release from PyPI. Restart Codex afterward; note the cached file is replaced on plugin updates.

Why is Codex running an old ToolUniverse version after updating?▼

A global uv tool install tooluniverse shadows the uvx invocation, so the old copy keeps running. Check with uv tool list, remove it via uv tool uninstall tooluniverse, then restart Codex.

Does the ToolUniverse Codex plugin require API keys?▼

Most tools work without keys, but keys like NCBI_API_KEY, ONCOKB_API_TOKEN, and SEMANTIC_SCHOLAR_API_KEY raise rate limits or unlock gated databases. Export them in the shell before launching Codex so the uvx MCP server inherits them.

Related Skills

Explore More Software Engineering Skills→
ulpi-ioulpi-io
13

codex-review

Generate focused instruction files for OpenAI Codex CLI code reviews.

Official
Intermediate
ynulihaoynulihao
564

tooluniverse

Provides unified access to 600+ scientific tools, models, and APIs.

Community
Advanced
render-ossrender-oss

render-mcp

Configure and authenticate the Render MCP server for Cursor, Claude Code, and Codex.

Official
Advanced
CentauriounCentaurioun

setup-tooluniverse

Install and configure ToolUniverse for MCP chat, CLI, and Python SDK usage.

Community
Advanced