Description
toolshed provides a unified interface for managing MCP (Multi-Agent Communication Protocol) servers, specifically designed for integration with Claude Code and Codex. This tool simplifies the process of adding and configuring various types of servers, including npm and Python packages, command-line interfaces that speak MCP, and remote URLs. A core feature is its ability to verify that a server is functional and lists its available tools before it's ever presented to an AI agent, preventing errors and ensuring smooth operation.
Read More
One of the significant advantages of toolshed is its secure handling of API tokens. Instead of storing sensitive credentials in plain-text configuration files, toolshed leverages the macOS Keychain or Linux Secret Service. This enhances security by keeping tokens encrypted and managed by the operating system's secure storage mechanisms. Servers are launched via a small wrapper that retrieves tokens from the keychain, applicable to both local and remote server setups.
The tool offers a user-friendly Text User Interface (TUI) and command-line options for managing tools. Users can easily add, start, inspect, install, uninstall, and delete tools. It also supports importing existing servers that were set up manually, allowing users to migrate their tokens to the secure keychain. For collaborative environments, toolshed enables sharing a consistent toolbox configuration across a team by committing a small YAML file to version control.
Furthermore, toolshed itself can act as an MCP server, allowing AI agents like Claude Code or Codex to directly request the addition of new servers. This agent-driven server management includes capabilities like `list_servers`, `inspect_server`, `add_server`, `install_server`, and `uninstall_server`. However, for security, any agent-added server requires explicit user approval before it can be started or installed, and agents cannot directly handle secrets or replace existing tools that might inherit secrets. This ensures that users maintain control over what runs on their machine and how sensitive information is handled. toolshed is open-source, MIT licensed, and available for macOS and Linux.
- CategoryAI DevOps & Cloud Tools
- Pricing ModelOpen Source
- DeploymentSelf-hosted
- PlatformsmacOS, Linux
toolshed's Core Features
Add npm or Python packages as MCP servers
Integrate any CLI that speaks MCP
Add remote URLs as MCP servers
Verify server functionality before agent use
Securely store API tokens in macOS Keychain or Linux Secret Service
One-keypress installation into Claude Code and Codex
Install tools for all projects or a single repository
Import manually configured servers and move tokens to keychain
toolshed acts as an MCP server for agent-driven management
Agent can list, inspect, add, install, and uninstall servers
User approval required for agent-added servers
Share toolboxes with teams via YAML configuration
Open-source and MIT licensed
Available for macOS and Linux
Text User Interface (TUI) and command-line interface
How to use toolshed?
Install toolshed: Use `go install github.com/bartdegoede/toolshed/cmd/toolshed@latest` or other provided methods.
Run toolshed: Execute the `toolshed` command to view your current tools and built-in examples.
Add a tool: Press 'a' in the TUI, specify the type (npm, Python, command, or URL), and name it.
Check tool functionality: Press 't' to start the server and list its tools, ensuring it works.
Install a tool: Press 'i' (or Enter) to install it into Claude Code or Codex, providing any necessary values and choosing installation scope.
Manage secrets: When installing, secrets are prompted for securely and stored in your keychain.
Import existing servers: Press 'm' to import servers already configured in Claude Code and Codex.
Approve agent-added servers: If an agent adds a server, review and approve it in the TUI by pressing 'i' or using `toolshed approve <id>`.
toolshed's Use Cases
- AI Agent Tool Management
- Secure Token Storage
- Developer Workflow Enhancement
- Team Collaboration
- Automated Server Provisioning
- Migrating Existing Servers






