OneTool MCP

v2.2.2Developer Toolsstable

One MCP for developers — no tool tax, no context rot. 100+ tools including Brave, Google, Tavily, Context7, Excalidraw, AWS, Excel, Database, Playwright, Chrome DevTools, and more. Install once, access everything.

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

What is OneTool MCP?

OneTool MCP 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, tavily, context7, excalidraw, aws, excel, database, playwright, chrome devtools, and more. install once, acces...

One MCP for developers — no tool tax, no context rot. 100+ tools including Brave, Google, Tavily, Context7, Excalidraw, AWS, Excel, Database, Playwright, Chrome DevTools, and more. Install once, access everything.

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+ t

Use Cases

100+ integrated developer tools
Search, Excel, database, DevTools in one
Zero tool overhead
beycom

Maintainer

LicenseGPL 3.0
Languagepython
Versionv2.2.2
UpdatedMay 13, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx onetool-mcp

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 MCP

OneTool MCP is a unified Python MCP server that bundles 100+ developer tools from 27+ packs into a single MCP installation, eliminating the 'tool tax' where AI clients must read large tool-definition schemas on every request. It integrates web search (Brave, Google, Tavily), documentation lookup (Context7), browser automation (Playwright, Chrome DevTools), database tools, file operations, Excel processing, PDF conversion, image vision, diagramming (Excalidraw), AWS operations, RAG knowledge base, and LLM transforms — all accessible via code-style invocations that consume approximately 2,000 tokens instead of the 150,000+ tokens typical for many separate MCP servers.

Prerequisites

  • Python 3.10 or higher
  • uv package manager installed (`pip install uv` or via the uv installer)
  • Claude Code, Claude Desktop, or another MCP-compatible client
  • API keys for the specific tool packs you want to use (e.g., Brave Search API key, Tavily API key)
  • Optional: Docker for containerized deployment
1

Install OneTool MCP via uv

Install the package with all optional tool packs using uv tool install. The [all] extra includes every available pack.

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

Initialize the configuration directory

Run onetool init to create the default configuration files at ~/.onetool including onetool.yaml and secrets.yaml.

onetool init --config ~/.onetool
3

Configure API keys in secrets.yaml

Edit ~/.onetool/secrets.yaml to add API keys for the tool packs you want to use. Each pack that requires a key has a documented entry.

# ~/.onetool/secrets.yaml example entries:
brave_search_api_key: YOUR_BRAVE_API_KEY
tavily_api_key: YOUR_TAVILY_API_KEY
# Add other keys as needed for your selected packs
4

Register with your MCP client

Add OneTool MCP to Claude Code or Claude Desktop. Use `claude mcp add` to register the server pointing to the onetool serve command with your config and secrets paths.

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

Optionally disable telemetry

To opt out of telemetry, set the DO_NOT_TRACK environment variable or disable it in onetool.yaml.

export DO_NOT_TRACK=1
# Or in ~/.onetool/onetool.yaml:
# telemetry:
#   enabled: false

OneTool MCP Examples

Client configuration

Claude Desktop configuration for OneTool MCP using the onetool serve command with config and secrets files.

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

Prompts to try

Use these prompts in Claude after OneTool MCP is connected to access the full suite of integrated developer tools.

- "Search the web for 'React 19 new features' using Brave search"
- "Look up the Context7 documentation for the Zod library and show me the schema validation API"
- "Open Chrome DevTools for http://localhost:3000 and check the console for errors"
- "Query my local Postgres database: SELECT count(*) FROM users WHERE created_at > '2026-01-01'"
- "Convert this PDF at /tmp/report.pdf to markdown and summarize the key points"
- "Create an Excalidraw diagram showing a three-tier web architecture with load balancer, app servers, and database"

Troubleshooting OneTool MCP

onetool command not found after uv tool install

Run `uv tool list` to confirm installation. If listed but not on PATH, add the uv tools bin directory to your PATH: typically ~/.local/bin on Linux/macOS. Run `uv tool install --force 'onetool-mcp[all]'` to reinstall.

A specific tool pack (e.g., Brave search) returns authentication errors

Ensure the required API key is present in ~/.onetool/secrets.yaml with the correct key name. Obtain the key from the provider (Brave Search API at https://api.search.brave.com, Tavily at https://app.tavily.com) and re-run `onetool serve`.

Claude sees very few tools even though all packs are installed

OneTool uses code-style invocations to reduce token overhead, so the tool list may appear smaller than expected. Ask Claude: 'What tool packs are available in onetool and how do I invoke the brave.search tool?' to discover the full capability set.

Frequently Asked Questions about OneTool MCP

What is OneTool MCP?

OneTool MCP is a Model Context Protocol (MCP) server that one mcp for developers — no tool tax, no context rot. 100+ tools including brave, google, tavily, context7, excalidraw, aws, excel, database, playwright, chrome devtools, and more. install once, access everything. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install OneTool MCP?

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

Which AI clients work with OneTool MCP?

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

Is OneTool MCP free to use?

Yes, OneTool MCP 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-mcp": { "command": "npx", "args": ["-y", "onetool-mcp"] } } }

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

Read the full setup guide →

Ready to use OneTool MCP?

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