@cubby-pro/mcp

MCP (Model Context Protocol) server for Cubby -- deploy apps, manage secrets, and interact with Cubby programmatically from AI tools like Claude Desktop and Cursor.

Prerequisites

You must be logged in to Cubby first. Run this in your terminal:

npx cubbypro login

The MCP server reads credentials from the same store as the CLI, so you only need to log in once.

Setup

Claude Desktop

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "cubby": {
      "command": "npx",
      "args": ["-y", "@cubby-pro/mcp"]
    }
  }
}

Restart Claude Desktop after saving.

Cursor

Add to your Cursor MCP settings (.cursor/mcp.json in your project or global settings):

{
  "mcpServers": {
    "cubby": {
      "command": "npx",
      "args": ["-y", "@cubby-pro/mcp"]
    }
  }
}

Claude Code

Add to your Claude Code MCP settings (.claude/settings.json):

{
  "mcpServers": {
    "cubby": {
      "command": "npx",
      "args": ["-y", "@cubby-pro/mcp"]
    }
  }
}

Available Tools

| Tool | Description | Parameters | |------|-------------|------------| | list_apps | List all deployed Cubby apps | None | | deploy | Deploy an app to Cubby | directory (required), name (optional) | | delete_app | Delete a deployed app | name | | list_secrets | List secret names for an app | app | | set_secret | Set a secret for an app | app, name, value | | delete_secret | Delete a secret from an app | app, name |

Troubleshooting

"Not authenticated" Run npx cubbypro login in your terminal first. The MCP server shares credentials with the CLI.

"Transport error" or server won't start Ensure Node.js >= 18 is installed. Try running npx @cubby-pro/mcp directly in your terminal to check for errors (output goes to stderr).

Tools not appearing Restart your MCP client (Claude Desktop, Cursor) after adding the configuration.