Provides tools for extracting, analyzing, and downloading TikTok content including HD no-watermark videos and photo slideshows, with support for single posts, mobile short links, and bulk profile downloads organized into date-based folders with comprehensive engagement analytics.
Click on "Install 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., "@tiktok-downloader-mcp download the TikTok video from https://vm.tiktok.com/abc123"
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.
All-in-one TikTok extraction suite: Run it directly from your terminal as a Standalone CLI tool (no AI required) or connect it as a Model Context Protocol (MCP) Server for AI assistants (Claude Code, Claude Desktop, Cursor, Windsurf, Antigravity).
Extract, analyze, and bulk-download TikTok HD videos (.mp4) and photo slideshows/carousels in original quality without watermarks, organized into structured date folders (YYYY-MM-DD_<id>) with comprehensive account engagement analytics.
Related MCP server: TikTok MCP Server
⚡ Dual Execution: Use directly in your terminal via npx or integrate as an MCP server with LLMs.
🎥 HD No-Watermark Videos: Download high-resolution .mp4 video files with original cover thumbnails.
📸 HD No-Watermark Photos: Extract full-resolution original photos and carousel slides.
📁 Date-Based Organization: Every post is filed under YYYY-MM-DD_<id>/.
📊 Rich Engagement Analytics:
Total Views (play_count)
Total Likes (digg_count)
Total Comments (comment_count)
Total Shares (share_count)
Total Favorites / Saves (collect_count)
Total Downloads (download_count)
Average Engagement Rate (%)
Top Performing Posts (Most viewed, most liked, most shared, most commented)
📝 Dual-Layer JSON Summaries:
account_summary.json & account_activity.json in the root account directory.
post.json & account_activity_recap.json inside every single post folder.
🚀 Zero Login / Cookies Needed: Works seamlessly out of the box with public TikTok endpoints.
You can run the downloader in your terminal without any AI assistant or configuration.
# Option A: One-liner via NPX (No installation needed)
npx tiktok-downloader-mcp <arguments>
# Option B: Global NPM install
npm install -g tiktok-downloader-mcp
tiktok-downloader-mcp <arguments>
# Option C: Local Git Clone
git clone https://github.com/abdouldotdev/tiktok-downloader-mcp.git
cd tiktok-downloader-mcp && npm install && npm run build
node dist/index.js <arguments>Downloads all slides in full resolution and saves metadata:
npx tiktok-downloader-mcp "https://www.tiktok.com/@username/photo/7405928371928371234"Generated structure:
tiktok_downloads/
└── username/
└── 2026-08-16_7405928371928371234/
├── slide_01.jpg
├── slide_02.jpg
├── slide_03.jpg
├── cover.jpg
└── post.jsonDownloads the unwatermarked HD video and its cover thumbnail:
npx tiktok-downloader-mcp "https://www.tiktok.com/@username/video/7106594312292453675"Generated structure:
tiktok_downloads/
└── username/
└── 2026-08-15_7106594312292453675/
├── video.mp4 # Clean HD video without watermark
├── cover.jpg # Video thumbnail
└── post.json # Views, likes, comments, sound metadatavm.tiktok.com)Shortened mobile URLs are automatically resolved:
npx tiktok-downloader-mcp "https://vm.tiktok.com/ZMhNxxxx/"Scans a profile, downloads both photos and videos, and computes total account engagement analytics:
# Download recent 50 posts (default):
npx tiktok-downloader-mcp @username
# Download recent 20 posts:
npx tiktok-downloader-mcp @username --max 20
# Download ALL posts from the profile:
npx tiktok-downloader-mcp @username --max allFilters out standalone videos and downloads only photo slideshows / carousels:
npx tiktok-downloader-mcp @username --media photos
# or:
npx tiktok-downloader-mcp @username --photos-only --max 30Filters out photo slideshows and downloads only HD MP4 video posts:
npx tiktok-downloader-mcp @username --media videos
# or:
npx tiktok-downloader-mcp @username --videos-only --max 30Specify where files should be stored:
npx tiktok-downloader-mcp @username --out "/Users/me/Desktop/MyTikTokMedia"Flag | Values | Default | Description |
|
| Required | Profile username, profile URL, or direct post URL |
|
|
| Filter media types to download |
| - |
| Shortcut for |
| - |
| Shortcut for |
|
|
| Maximum number of posts to fetch |
|
|
| Target output directory on your system |
| - | - | Display help menu |
Connect the server to an AI assistant to let the LLM extract, analyze, and download TikTok content for you via natural language.
# Add via NPX:
claude mcp add tiktok-downloader -- npx -y tiktok-downloader-mcp
# Or directly from GitHub:
claude mcp add tiktok-downloader -- npx -y github:abdouldotdev/tiktok-downloader-mcpCheck status inside Claude Code:
/mcpAdd to your claude_desktop_config.json:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"tiktok-downloader": {
"command": "npx",
"args": ["-y", "tiktok-downloader-mcp"]
}
}
}Add to .cursor/mcp.json or project .mcp.json:
{
"mcpServers": {
"tiktok-downloader": {
"command": "npx",
"args": ["-y", "tiktok-downloader-mcp"]
}
}
}agy mcp add tiktok-downloader -- npx -y tiktok-downloader-mcpTool | Purpose | Parameters | Natural Language Example |
| Extracts unwatermarked media URLs, audio, and metrics without saving files. |
| "Extract the images, audio, and view count from this link: https://www.tiktok.com/@user/photo/123" |
| Lists recent post IDs, upload dates, and URLs for a profile. |
| "List the last 15 posts published by @username with their dates." |
| Downloads a single post (photos or video) to a date folder with |
| "Download this TikTok video in HD to my downloads folder." |
| Bulk downloads videos/photos into date folders and creates global |
| "Download all photo carousels from @username and summarize their engagement." |
| Computes account totals, averages, engagement rate, and top posts without downloading files. |
| "Analyze the engagement rate and top performing posts of @username." |
account_summary.json (Account Level)Saved at the root of the user folder (tiktok_downloads/<username>/account_summary.json):
{
"account": {
"username": "example_user",
"nickname": "Creator Name",
"user_id": "7582772389835113485",
"avatar": "https://.../avatar.jpeg",
"profile_url": "https://www.tiktok.com/@example_user"
},
"activity_totals": {
"total_posts_analyzed": 50,
"total_slideshows_count": 32,
"total_videos_count": 18,
"total_images_count": 312,
"total_views": 1066188,
"total_likes": 17388,
"total_comments": 6078,
"total_shares": 410,
"total_favorites_saves": 2579,
"total_downloads": 74,
"total_all_interactions": 26455
},
"performance_averages": {
"avg_views_per_post": 21324,
"avg_likes_per_post": 348,
"avg_comments_per_post": 121.6,
"avg_shares_per_post": 8.2,
"avg_favorites_per_post": 51.6,
"avg_engagement_rate_percent": 2.48
},
"top_performing_posts": {
"most_viewed": { "id": "7652520719259159822", "date": "2026-06-18", "views": 461748, "type": "slideshow" },
"most_liked": { "id": "7652520719259159822", "date": "2026-06-18", "likes": 5558, "type": "slideshow" }
},
"updated_at": "2026-08-18T15:57:52.024Z"
}post.json (Post Level)Saved inside each individual post folder (tiktok_downloads/<username>/YYYY-MM-DD_<id>/post.json):
{
"post_details": {
"id": "7674774636999003406",
"user": "example_user",
"author": { "uniqueId": "example_user", "nickname": "Creator Name" },
"title": "Summer outfit ideas #fashion #summer",
"media_type": "slideshow",
"date": "2026-08-16",
"timestamp": 1787049600,
"url": "https://www.tiktok.com/@example_user/video/7674774636999003406",
"slides_count": 10,
"stats": {
"views": 1120,
"likes": 21,
"comments": 17,
"shares": 1,
"favorites": 5,
"downloads": 0,
"total_interactions": 44,
"engagement_rate_percent": 3.93
},
"music": {
"id": "7644346595656730640",
"title": "Original Sound",
"author": "Sound Creator",
"duration": 60,
"play_url": "https://.../audio.mp4"
}
},
"account_recap": {
"username": "example_user",
"activity_totals": { "total_views": 1066188, "total_likes": 17388 },
"performance_averages": { "avg_engagement_rate_percent": 2.48 }
}
}tiktok_downloads/
└── example_user/
├── account_summary.json # Cumulative totals, averages, engagement & top posts
├── account_activity.json # Complete chronological history of all posts
│
├── 2026-08-16_7674774636999003406/ # 📸 Photo Slideshow post folder
│ ├── slide_01.jpg
│ ├── slide_02.jpg
│ ├── slide_03.jpg
│ ├── cover.jpg
│ ├── post.json # Individual post metrics + global account recap
│ └── account_activity_recap.json
│
└── 2026-08-15_7674392602606619917/ # 🎬 Video post folder
├── video.mp4 # HD unwatermarked video
├── cover.jpg # Video cover thumbnail
├── post.json
└── account_activity_recap.jsonA: No. All downloads and metadata extractions work out of the box using public endpoints without any login or session cookies.
A: No. 100% of the downloaded media files are clean, original-quality files without the TikTok bouncing watermark.
A: No. The tool checks file size and presence on disk. If a slide or video has already been downloaded, it will automatically skip it for instant speed.
A: Node.js >= 18. For profile scanning, yt-dlp is recommended (brew install yt-dlp on macOS or pip install yt-dlp).
# Clone repository
git clone https://github.com/abdouldotdev/tiktok-downloader-mcp.git
cd tiktok-downloader-mcp
# Install dependencies
npm install
# Compile TypeScript
npm run build
# Run CLI locally
node dist/index.js @username --max 10
# Run MCP Server on stdio
node dist/index.js --stdioMIT © abdouldotdev
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Download YouTube, TikTok, Vimeo, SoundCloud and 6 more platforms from any MCP AI chatbot.
MCP server for Clipkit — gives AI agents a video toolbox via the Clipkit schema.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/abdouldotdev/tiktok-downloader-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server