OneTool

v1.0.0Developer Toolsstable

🧿 One MCP for developers - no tool tax, no context rot. 100+ tools including Brave, Google, Context7, Excalidraw, AWS, Version Checker, Excel, File Ops, Database, Playwright, Chrome DevTools and many more.

claudeclaude-codellmmcpmcp-server
Share:
18
Stars
0
Downloads
0
Weekly
0/5

What is OneTool?

OneTool is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 🧿 one mcp for developers - no tool tax, no context rot. 100+ tools including brave, google, context7, excalidraw, aws, version checker, excel, file ops, database, playwright, chrome devtools and many...

🧿 One MCP for developers - no tool tax, no context rot. 100+ tools including Brave, Google, Context7, Excalidraw, AWS, Version Checker, Excel, File Ops, Database, Playwright, Chrome DevTools and many more.

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • 🧿 One MCP for developers - no tool tax, no context rot. 100+

Use Cases

100+ developer tools unified
Search, Excel, database, and automation
beycom

Maintainer

LicenseGPL-3.0
Languagepython
Versionv1.0.0
UpdatedMay 13, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx onetool

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 OneTool

OneTool MCP is a unified developer toolkit that consolidates 230+ tools across 27 capability packs into a single MCP server, eliminating the token overhead of loading multiple separate servers. It covers web search (Brave, Tavily, Google), documentation lookup (Context7), browser automation (Playwright, Chrome DevTools), document processing (PDF, Excel, DOCX), database queries, AI vision, a built-in knowledge base with vector search, and much more. Developers using Claude Code or other MCP clients can access all these capabilities with roughly 2,000 tokens per request instead of tens of thousands.

Prerequisites

  • Python 3.10 or higher with uv package manager installed
  • An MCP client such as Claude Code or Claude Desktop
  • API keys for the specific tool packs you want to enable (e.g., Brave Search API key, Tavily API key)
  • Node.js if using browser automation packs
1

Install OneTool via uv

Install the onetool-mcp package with all optional packs enabled using the uv tool installer.

uv tool install 'onetool-mcp[all]'
2

Initialize the configuration directory

Create the default config and secrets files under ~/.onetool. You will edit these to enable packs and add API keys.

onetool init --config ~/.onetool
3

Edit secrets.yaml with your API keys

Open ~/.onetool/secrets.yaml and add keys for the packs you want to use, such as Brave Search, Tavily, or others.

# Example entries in ~/.onetool/secrets.yaml
brave_api_key: "YOUR_BRAVE_KEY"
tavily_api_key: "YOUR_TAVILY_KEY"
4

Register the server with your MCP client

Add the OneTool server to Claude Code using the CLI command, pointing at your config and secrets files.

claude mcp add onetool -- onetool serve --config ~/.onetool/onetool.yaml --secrets ~/.onetool/secrets.yaml
5

Disable telemetry (optional)

If you prefer not to send anonymous startup pings, set the DO_NOT_TRACK environment variable or disable telemetry in onetool.yaml.

export DO_NOT_TRACK=1

OneTool Examples

Client configuration

JSON config block for claude_desktop_config.json to launch OneTool via stdio transport.

{
  "mcpServers": {
    "onetool": {
      "command": "onetool",
      "args": [
        "serve",
        "--config", "/Users/you/.onetool/onetool.yaml",
        "--secrets", "/Users/you/.onetool/secrets.yaml"
      ],
      "env": {
        "DO_NOT_TRACK": "1"
      }
    }
  }
}

Prompts to try

Prompts that demonstrate OneTool's breadth across search, documents, database, and AI vision packs.

- "Search the web for the latest React 19 release notes using Brave"
- "Look up the official MCP SDK documentation and summarize the tool definition format"
- "Read this PDF report and extract all the financial figures"
- "Run this SQL query against my local SQLite database: SELECT * FROM users LIMIT 10"
- "Analyze this screenshot and tell me what UI components are visible"

Troubleshooting OneTool

onetool command not found after installation

Ensure uv's bin directory is on your PATH. Run 'uv tool dir' to find where tools are installed and add that path to your shell profile.

A tool pack returns authentication errors

Open ~/.onetool/secrets.yaml and verify the API key for that pack is correctly set. Keys must match the exact field names documented for each pack.

Server starts but Claude Code shows no tools

Restart Claude Code after registering the server. Also confirm that the onetool.yaml has the desired packs listed under 'enabled' or uses the default 'all' setting.

Frequently Asked Questions about OneTool

What is OneTool?

OneTool is a Model Context Protocol (MCP) server that 🧿 one mcp for developers - no tool tax, no context rot. 100+ tools including brave, google, context7, excalidraw, aws, version checker, excel, file ops, database, playwright, chrome devtools and many more. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install OneTool?

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

Which AI clients work with OneTool?

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

Is OneTool free to use?

Yes, OneTool is open source and available under the GPL-3.0 license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

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

Quick Config Preview

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

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

Read the full setup guide →

Ready to use OneTool?

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