OpenAI Tool2MCP
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.
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
Maintainer
Works with
Installation
Manual Installation
npx openai-tool2mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
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)
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.gitSet 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"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 stdioConfigure your MCP client
Add the OpenAI Tool2MCP server to your MCP client configuration, passing OPENAI_API_KEY as an environment variable.
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.
OpenAI Tool2MCP Alternatives — Similar APIs Servers
Looking for alternatives to OpenAI Tool2MCP? Here are other popular apis servers you can use with Claude, Cursor, and VS Code.
Kong
★ 43.4k🦍 The API and AI Gateway
API Mega List
★ 5.4kThis GitHub repo is a powerhouse collection of APIs you can start using immediately to build everything from simple automations to full-scale applications. One of the most valuable API lists on GitHub—period. 💪
Fetch
★ 5.4kFetch web content and convert to markdown for AI consumption
Fusio
★ 2.1kSelf-Hosted API Management for Builders
Korean Law
★ 1.8k국가법령정보MCP v4.0 | 법제처 41개 API → 17개 MCP 도구. 법령·판례·조례 검색 + LLM 환각 방지 인용검증 + 조문 영향 그래프(impact_map) + 시점 비교 자동 diff(time_travel) + 시민 5단계 실행 가이드(action_plan) | 41 Korean legal APIs → 17 MCP tools
RuleGo
★ 1.5k⛓️RuleGo is a lightweight, high-performance, embedded, next-generation component orchestration rule engine framework for Go.
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.
Set Up OpenAI Tool2MCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
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.