Anybox

You can run an MCP server for Anybox to let Claude Desktop and other MCP clients interact with your bookmarks. This server exposes search, tag and folder listings, and the ability to save new bookmarks with metadata, all through a consistent MCP interface.

How to use

Once the MCP server is running, you can perform practical actions from your MCP client: search bookmarks by keyword, tag, folder, or starred status; list all tags with their IDs and counts; list all folders with IDs and counts; and save new bookmarks with optional tags, folders, comments, and starred status. These capabilities let you manage your Anybox bookmarks from your preferred MCP-enabled workflow.

How to install

Prerequisites: macOS with Anybox installed and running, Python 3.10 or higher, and your Anybox API key.

1. Clone or download the project to your local machine.

2. Create and activate a virtual environment, then install dependencies.

cd ~/coding/anyboxTidier
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

3. Set your API key in the client configuration. You won’t export it globally; you’ll provide it to the MCP server via the client setup.

4. Configure Claude Desktop to use the MCP server. You have two options.

Option 1: Automated Setup (Recommended)

./setup_claude_desktop.sh

This setup will test your Anybox API connection, automatically configure Claude Desktop, and verify everything is working.

Option 2: Manual Configuration

Locate the Claude Desktop config file on macOS and add the MCP server configuration as shown.

{
  "mcpServers": {
    "anybox": {
      "command": "/Users/tommertron/coding/anyboxTidier/venv/bin/python",
      "args": [
        "/Users/tommertron/coding/anyboxTidier/anybox_mcp_server.py"
      ],
      "env": {
        "ANYBOX_API_KEY": "your-api-key-here"
      }
    }
  }
}

Important: Replace /Users/tommertron/coding/anyboxTidier with the actual path to where you cloned this project and replace your-api-key-here with your real Anybox API key. Ensure you use the full path to the Python interpreter in the virtual environment.

5. Restart Claude Desktop after updating the config.

Additional setup and notes

You can run the MCP server directly to test locally.

To start the server manually, run the following command from the project directory:

python3 anybox_mcp_server.py

Troubleshooting

Connection issues may indicate the Anybox API is not reachable or the API key is incorrect. Verify Anybox is running and the local API is accessible at the expected address. You can test the API with a simple request using your API key as a header.

Common checks:

• • Make sure the API is listening on the expected localhost port (for example 6391)
• • Confirm the API key you configured matches the key shown in Anybox Preferences

API reference and endpoints

The server communicates with Anybox’s local HTTP API at http://127.0.0.1:6391. Endpoints include search, tags, folders, and save operations, all authenticated with your API key.

Development and tools

Development is focused on exposing MCP-compatible tools that map to Anybox actions. The server supports functions such as searching bookmarks, listing tags, listing folders, and saving bookmarks with metadata.

Credits and license

MIT License. This MCP server is designed to enable seamless interaction between Claude Desktop and Anybox bookmarks.

Available tools

search_bookmarks

Search bookmarks with filters such as query, tag_id, folder_id, and starred status; limit results.

list_tags

List all tags with IDs and bookmark counts for your Anybox collection.

list_folders

List all folders with IDs and bookmark counts in Anybox.

save_bookmark

Save a new bookmark by URL/note with optional tags, folder, comment, and starred flag.