bucket-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@bucket-mcp find the pasta recipe from that reel I saved last week"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
bucket-mcp
MCP server for Bucket — connect Claude to your Bucket so it can search, read, and download everything you've saved: Instagram reels, TikToks, tweets, YouTube videos, links, and notes.
you: "grab that pasta reel I saved last week and pull the recipe out of the transcript"
claude: searches your bucket → reads the transcript → downloads the video into your projectSetup
1. Get an API key — log in at bucketai.net → Settings → Claude Connector → Generate API Key. Copy it (it's shown once).
2. Add to Claude Code:
claude mcp add bucket -e BUCKET_API_KEY=bk_your_key_here -- npx -y bucket-mcpOr Claude Desktop — add to claude_desktop_config.json:
{
"mcpServers": {
"bucket": {
"command": "npx",
"args": ["-y", "bucket-mcp"],
"env": { "BUCKET_API_KEY": "bk_your_key_here" }
}
}
}Related MCP server: mcp-server-claude
Tools
Tool | What it does |
| Semantic search over everything you've saved ("that pasta place video") |
| Browse recent saves, filterable by category ( |
| Full detail: complete transcript, summary, OCR text, visual description, locations |
| Download a saved reel/TikTok/tweet video as an MP4 into your working directory |
| Save a URL into your Bucket from Claude |
Configuration
Env var | Required | Default |
| yes | — |
| no | Bucket production API |
Development
npm install
npm run build
BUCKET_API_KEY=bk_... node dist/index.js # speaks MCP over stdioLicense
MIT
Available Tools
5 toolsdownload_videoA
Download a saved item's video (reel/TikTok/tweet video) as an MP4 file written to the local filesystem. Returns the absolute path of the written file.
Inputs: message_id (required), output_path.
get_itemA
Full detail for one saved item: complete transcript, summary, OCR text, visual description, locations, and original URL.
Inputs: message_id (required).
list_recentA
List recently saved Bucket items, optionally filtered by category (e.g. instagram, tiktok, twitter, youtube, recipes, fitness…).
Inputs: limit, category.
save_to_bucketA
Save a URL (reel, TikTok, tweet, article…) into the user's Bucket. Bucket extracts, summarizes, and categorizes it in the background.
Inputs: url (required).
search_bucketA
Semantic search over everything saved in the user's Bucket (reels, TikToks, tweets, links, notes). Returns matches with summaries; use get_item for full detail.
Inputs: query (required), limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool serves a distinct purpose: search, list recent, get detail, download video, and save. There is no overlap in actions or resources, making it easy for an agent to select the correct tool.
Most tools follow a clear verb_noun pattern (search_bucket, get_item, download_video, save_to_bucket), but 'list_recent' omits the noun and 'save_to_bucket' includes a preposition, creating a minor inconsistency. Overall, the style is still predictable and readable.
Five tools is well-scoped for a content saving and retrieval service. Each tool covers a distinct operation without unnecessary redundancy, and the count falls comfortably within the ideal range.
The set covers the main workflow (save, search, list, get detail, download) but lacks a delete operation, which is a fundamental part of managing saved content. This is a notable gap that could force agents to leave items in the bucket indefinitely.
Maintenance
Related MCP Connectors
Social media MCP server: your Instagram, TikTok, YouTube, LinkedIn and Threads history for your AI.
Hosted Web Crawler MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Hosted X (Twitter) MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Remote streamable-HTTP MCP server running on a single Cloudflare Worker. Your assistant gets live Airbnb, Amazon, Booking.com, Google Flights, Maps and Reddit data, social search on X, Instagram and TikTok, the Meta Ad Library, and image/video generation without any keys. Connect your own accounts to let it send WhatsApp or Telegram messages, work an IMAP inbox, manage Meta Ads campaigns and publish to X and LinkedIn. OAuth 2.1 with PKCE; stored credentials are AES-256-GCM encrypted.
Related MCP Servers
- AlicenseAqualityDmaintenanceA Model Context Protocol (MCP) server that enables Claude or other LLMs to fetch content from URLs, supporting HTML, JSON, text, and images with configurable request parameters.33MIT
- AlicenseNot gradedqualityDmaintenanceMCP Memory Server for Claude Code that provides persistent context across sessions using semantic search (RAG).Apache 2.0
- AlicenseNot gradedqualityDmaintenanceAn MCP server for storing and retrieving thoughts, notes, and ideas with semantic vector search, enabling integration with Claude Desktop and other MCP clients.MIT
- AlicenseAqualityBmaintenancePersistent knowledge-base MCP server. Semantic search with source citations over saved YouTube videos, podcasts, articles and PDFs — one endpoint for every MCP-capable AI client.28Elastic 2.0