Kaggle MCP server
io.github.Seif-Sameh/Kaggle-mcp·v0.1.1MCP server for the Kaggle API: competitions, datasets, kernels, and models.
0 stars28 downloads/wk
Reviews
Write oneNobody has reviewed Kaggle yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Kaggle tools (39, 11 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
competition_download_fileDownload a specific file from a Kaggle competition.
competition_download_filesDownload all files from a Kaggle competition.
competition_leaderboard_downloadDownload the leaderboard data for a Kaggle competition to a local file.
competition_leaderboard_viewRetrieve the current leaderboard for a Kaggle competition.
competition_list_filesList files available in a Kaggle competition.
competition_submissionsGet a list of all the submissions for a particular competition.
competition_submitwrite actionSubmit a file to a Kaggle competition.
competitions_listList Kaggle competitions with optional filtering.
dataset_createwrite actionCreate a new Kaggle dataset from a local folder with metadata configuration.
dataset_create_versionwrite actionCreate a new version of an existing Kaggle dataset.
dataset_download_fileDownload a specific file from a Kaggle dataset to a local directory.
dataset_download_filesDownload all files from a Kaggle dataset to a local directory.
dataset_initializeInitialize a new Kaggle dataset in a local folder with metadata configuration.
dataset_list_filesRetrieve a list of all files contained within a specific Kaggle dataset.
dataset_metadataDownload the metadata file for a dataset.
dataset_statusGet the status of a dataset. Only for your own datasets.
datasets_listReturn a list of datasets.
kernel_initializeInitialize kernel metadata configuration in a specified folder.
kernel_list_filesList files associated with a specific Kaggle kernel.
kernel_outputDownload the execution output files from a Kaggle kernel.
kernel_pullDownload a Kaggle kernel and its files to a local directory.
kernel_pushPush a Kaggle kernel and its metadata from a local folder.
kernel_statusGet the status of a Kaggle kernel.
kernels_listSearch and list Kaggle kernels based on specified criteria.
model_createwrite actionCreate a new model on Kaggle using metadata from a local folder.
model_deletewrite actionDelete a model from Kaggle.
model_getRetrieve metadata and details for a specific Kaggle model, and save it as a JSON file.
model_initializeInitialize model metadata configuration in a specified folder.
model_instance_createwrite actionCreate a new model instance on Kaggle using metadata from a local folder.
model_instance_deletewrite actionDelete a model instance from Kaggle.
model_instance_getRetrieve details of a specific model instance from Kaggle and save as JSON.
model_instance_initializeInitialize model instance metadata configuration in a specified folder.
model_instance_updatewrite actionUpdate an existing model instance using metadata from a local folder.
model_instance_version_createwrite actionCreate a new version of an existing model instance.
model_instance_version_deletewrite actionDelete a specific version of a model instance from Kaggle.
model_instance_version_downloadDownload all files for a model instance version to a local directory.
model_instance_version_filesList all files contained in a specific model instance version.
model_updatewrite actionUpdate an existing model on Kaggle using metadata from a local folder.
models_listSearch and list Kaggle models based on specified criteria.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan5 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 107 days ago8/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Kaggle compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 72/100
- higher than 38% of 48,255 servers
- Tools
- 39
- the typical server has 7
- Tools that change things
- 28%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 28
- more than 15% of 12,191 servers with a package
What its tools let an agent do: 28 read · 11 change
Install Kaggle in Claude Code, Cursor or VS Code
claude mcp add Kaggle-mcp -- uvx mcp-server-kaggle
What the publisher says
From the Kaggle repository's README, as published. We do not edit it. Read it on GitHub
Kaggle MCP Server
<!-- mcp-name: io.github.Seif-Sameh/Kaggle-mcp -->
A Model Context Protocol (MCP) server that provides seamless integration with the Kaggle API. Interact with Kaggle competitions, datasets, kernels, and models through MCP-compatible clients like Claude Desktop.
Features
- Competitions: List, download files, submit, view leaderboards and submissions
- Datasets: Search, download, create, and manage datasets with version control
- Kernels: List, push, pull, and manage Kaggle notebooks and scripts
- Models: Create, update, and manage ML models and instances with full version control
Installation
Prerequisites
- Python 3.10 or higher
- A Kaggle account with API credentials
Install from PyPI
The recommended way is to run the server with uvx, which handles the install for you:
uvx mcp-server-kaggleOr install it explicitly:
pip install mcp-server-kaggle
# or
uv tool install mcp-server-kaggleInstall from Source
For development or local modifications:
git clone https://github.com/Seif-Sameh/Kaggle-mcp.git
cd Kaggle-mcp
uv syncSetup
1. Get Your Kaggle API Credentials
- Go to https://www.kaggle.com/account
- Scroll to the "API" section
- Click "Create New Token"
- This downloads kaggle.json with your credentials
2. Configure Credentials
Option A: Environment Variables (Recommended)
export KAGGLE_USERNAME=your_username
export KAGGLE_API_KEY=your_api_keyOr add to your ~/.zshrc or ~/.bashrc:
echo 'export KAGGLE_USERNAME=your_username' >> ~/.zshrc
echo 'export KAGGLE_API_KEY=your_api_key' >> ~/.zshrc
source ~/.zshrcOption B: Using .env File
Create a .env file in your project directory:
KAGGLE_USERNAME=your_username
KAGGLE_API_KEY=your_api_keyUsage
With Claude Desktop
The recommended way to use Kaggle MCP is with Claude Desktop.
- Locate your Claude Desktop config file:
- macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json
- Windows: %APPDATA%\Claude\claudedesktopconfig.json
- Linux: ~/.config/Claude/claudedesktopconfig.json
- Add the Kaggle MCP server configuration:
{
"mcpServers": {
"kaggle": {
"command": "uvx",
"args": ["mcp-server-kaggle"],
"env": {
"KAGGLE_USERNAME": "YOUR_KAGGLE_USERNAME",
"KAGGLE_API_KEY": "YOUR_KAGGLE_API_KEY"
}
}
}
}Running from a local source clone (alternative)
{
"mcpServers": {
"kaggle": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/Kaggle-mcp",
"run",
"mcp-server-kaggle"
],
"env": {
"KAGGLE_USERNAME": "YOUR_KAGGLE_USERNAME",
"KAGGLE_API_KEY": "YOUR_KAGGLE_API_KEY"
}
}
}
}- Restart Claude Desktop
- Start using Kaggle through Claude!
Try asking Claude:
- "List the latest Kaggle competitions"
- "Download the Titanic dataset"
- "Show me my recent competition submissions"
- "Search for NLP datasets"
Standalone Usage
Run the MCP server directly:
mcp-server-kaggleOr as a Python module:
python -m kaggle_mcpAvailable Tools
Competitions (8 tools)
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Kaggle: common questions
- Is Kaggle MCP server safe?
- Mostly: it is graded B (72/100). Read the Kaggle safety report
- How do I install Kaggle?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Kaggle need an API key?
- Yes. The registry entry asks for
KAGGLE_API_KEY. - Is Kaggle maintained?
- The last commit was 145 days ago (2026-06-12). The latest release is v0.1.1.
- How does Kaggle compare with other MCP servers?
- safety score 72/100 (higher than 38% of 48,255 servers); tools 39 (the typical server has 7); tools that change things 28% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.