OpenAI Tool2MCP

v1.0.0APIsstable

A lightweight bridge that wraps OpenAI's built-in tools (like web search and code interpreter) as Model Context Protocol servers, enabling their use with Claude and other MCP-compatible models.

openai-tool2mcpmcpai-integration
Share:
12
Stars
0
Downloads
0
Weekly
0/5

What is OpenAI Tool2MCP?

OpenAI Tool2MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to lightweight bridge that wraps openai's built-in tools (like web search and code interpreter) as model context protocol servers, enabling their use with claude and other mcp-compatible models.

A lightweight bridge that wraps OpenAI's built-in tools (like web search and code interpreter) as Model Context Protocol servers, enabling their use with Claude and other MCP-compatible models.

This server falls under the APIs and Coding Agents categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A lightweight bridge that wraps OpenAI's built-in tools (lik

Use Cases

Wrap OpenAI's web search and code interpreter as MCP servers.
Use OpenAI tools with Claude and other MCP-compatible models.
alohays

Maintainer

LicenseMIT License
Languagepython
Versionv1.0.0
UpdatedJan 28, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx openai-tool2mcp

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use OpenAI Tool2MCP

OpenAI Tool2MCP is a Python bridge that wraps OpenAI's built-in Assistant API tools — web search, code interpreter, web browser, and file management — as MCP servers, making them available to Claude and any other MCP-compatible AI client. It translates MCP tool calls into OpenAI Assistant API requests and returns the results, enabling AI assistants that do not natively have these capabilities to use them through the MCP protocol. Developers can use it to give Claude access to OpenAI's web search or code execution without switching platforms.

Prerequisites

  • Python 3.10 or higher installed
  • An OpenAI API key with access to the Assistants API
  • pip or uv package manager installed
  • An MCP client such as Claude Desktop
  • Sufficient OpenAI API credits for the tools you intend to use (web search and code interpreter have per-use costs)
1

Install the package

Install openai-tool2mcp from PyPI using pip or uv.

pip install openai-tool2mcp
# or install from source:
pip install git+https://github.com/alohays/openai-tool2mcp.git
2

Set your OpenAI API key

Export your OpenAI API key as an environment variable. This key must have Assistants API access enabled.

export OPENAI_API_KEY="your-openai-api-key-here"
3

Test the server manually

Verify the server starts correctly by running it directly with uv or Python.

uv run openai_tool2mcp/server_entry.py --transport stdio
4

Configure your MCP client

Add the OpenAI Tool2MCP server to your MCP client configuration, passing OPENAI_API_KEY as an environment variable.

5

Choose which OpenAI tools to expose

By default the server exposes all available built-in tools. You can restrict which tools are active by modifying the ServerConfig in the source or by using the configuration options at startup.

OpenAI Tool2MCP Examples

Client configuration

Add OpenAI Tool2MCP to Claude Desktop to give Claude access to OpenAI's web search and code interpreter.

{
  "mcpServers": {
    "openai-tool2mcp": {
      "command": "python",
      "args": ["-m", "openai_tool2mcp.server_entry", "--transport", "stdio"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here"
      }
    }
  }
}

Prompts to try

Example prompts to use OpenAI's built-in tools through Claude via the MCP bridge.

- "Search the web for the latest news on Model Context Protocol and summarize the top 5 results."
- "Use the code interpreter to calculate the compound interest on $10,000 at 5% over 10 years."
- "Search for recent Python 3.13 release notes and list the key new features."
- "Run a Python script to generate and plot a sine wave, then describe the output."

Troubleshooting OpenAI Tool2MCP

AuthenticationError: No API key provided

Ensure OPENAI_API_KEY is set in the environment block of your MCP client configuration. The server reads it at startup; if missing it will fail immediately with an authentication error.

Web search tool returns no results or access denied error

Web search requires an OpenAI account with Assistants API access and sufficient credits. Check your OpenAI account dashboard to confirm the Assistants API is enabled and your usage limits have not been reached.

Server starts but no tools appear in the MCP client

Restart the MCP client after adding the server configuration to force it to reconnect and enumerate tools. Also check that the Python module path 'openai_tool2mcp.server_entry' is accessible in the Python environment used by the command.

Frequently Asked Questions about OpenAI Tool2MCP

What is OpenAI Tool2MCP?

OpenAI Tool2MCP is a Model Context Protocol (MCP) server that lightweight bridge that wraps openai's built-in tools (like web search and code interpreter) as model context protocol servers, enabling their use with claude and other mcp-compatible models. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install OpenAI Tool2MCP?

Follow the installation instructions on the OpenAI Tool2MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with OpenAI Tool2MCP?

OpenAI Tool2MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is OpenAI Tool2MCP free to use?

Yes, OpenAI Tool2MCP is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More APIs MCP Servers

Explore all apis servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "openai-tool2mcp": { "command": "npx", "args": ["-y", "openai-tool2mcp"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use OpenAI Tool2MCP?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides