Kaggle-MCP: Kaggle API Integration for Claude AI
██╗ ██╗ █████╗ ██████╗ ██████╗ ██╗ ███████╗ ███╗ ███╗ ██████╗██████╗
██║ ██╔╝██╔══██╗██╔════╝ ██╔════╝ ██║ ██╔════╝ ████╗ ████║██╔════╝██╔══██╗
█████╔╝ ███████║██║ ███╗██║ ███╗██║ █████╗ ██╔████╔██║██║ ██████╔╝
██╔═██╗ ██╔══██║██║ ██║██║ ██║██║ ██╔══╝ ████─ ██║╚██╔╝██║██║ ██╔═══╝
██║ ██╗██║ ██║╚██████╔╝╚██████╔╝███████╗███████╗ ██║ ╚═╝ ██║╚██████╗██║
╚═╝ ╚═╝╚═╝ ╚═╝ ╚═════╝ ╚═════╝ ╚══════╝╚══════╝ ╚═╝ ╚═╝ ╚═════╝╚═╝
Kaggle-MCP connects Claude AI to the Kaggle API through the Model Context Protocol (MCP), enabling competition, dataset, and kernel operations through the AI interface.
Features
- Authentication: Securely authenticate with your Kaggle credentials
- Competitions: Browse, search, and download data from Kaggle competitions
- Datasets: Find, explore, and download datasets from Kaggle
- Kernels: Search for and analyze Kaggle notebooks/kernels
- Models: Access pre-trained models available on Kaggle
Quick Installation
The following commands install the base version of Kaggle-MCP.
macOS / Linux
# Install with a single command
curl -LsSf https://raw.githubusercontent.com/54yyyu/kaggle-mcp/main/install.sh | sh
Windows
# Download and run the installer
powershell -c "Invoke-WebRequest -Uri https://raw.githubusercontent.com/54yyyu/kaggle-mcp/main/install.ps1 -OutFile install.ps1; .\install.ps1"
Manual Installation
# Install with pip
pip install git+https://github.com/54yyyu/kaggle-mcp.git
# Or better, install with uv
uv pip install git+https://github.com/54yyyu/kaggle-mcp.git
Configuration
After installation, run the setup utility to configure Claude Desktop:
kaggle-mcp-setup
This will locate and update your Claude Desktop configuration file, which is typically found at:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
Manual Configuration
Alternatively, you can manually add the following to your Claude Desktop configuration:
{
"mcpServers": {
"kaggle": {
"command": "kaggle-mcp"
}
}
}
Kaggle API Credentials
To use Kaggle-MCP, you need to set up your Kaggle API credentials:
- Go to your Kaggle account settings
- In the API section, click "Create New API Token"
- This will download a
kaggle.jsonfile with your credentials - Move this file to
~/.kaggle/kaggle.json(create the directory if needed) - Set the correct permissions:
chmod 600 ~/.kaggle/kaggle.json
Alternatively, you can authenticate directly through Claude using the authenticate() tool with your username and API key.
Available Tools
For a comprehensive list of available tools and their detailed usage, please refer to the documentation at stevenyuyy.us/kaggle-mcp.
Examples
Ask Claude:
- "Authenticate with Kaggle using my username 'username' and key 'apikey'"
- "List active Kaggle competitions"
- "Show me the top 10 competitors on the Titanic leaderboard"
- "Find datasets about climate change"
- "Download the Boston housing dataset"
- "Search for kernels about sentiment analysis"
Use Cases
- Competition Research: Quickly access competition details, data, and leaderboards
- Dataset Discovery: Find and download datasets for analysis projects
- Learning Resources: Locate relevant kernels and notebooks for specific topics
- Model Discovery: Find pre-trained models for various machine learning tasks
Requirements
- Python 3.8 or newer
- Claude Desktop or API access
- Kaggle account with API credentials
- MCP Python SDK 1.6.0+
License
This project is licensed under the MIT License - see the LICENSE file for details.
Metadata
Release files for iflow-mcp_kaggle-mcp 0.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_kaggle_mcp-0.1.2.tar.gz | 16.0 kB | Without provenance | Details for iflow_mcp_kaggle_mcp-0.1.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_kaggle_mcp-0.1.2-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_kaggle_mcp-0.1.2-py3-none-any.whl |
Total release size: 37.7 kB
Release files / iflow_mcp_kaggle_mcp-0.1.2.tar.gz
| Download URL | iflow_mcp_kaggle_mcp-0.1.2.tar.gz |
|---|---|
| Size | 16.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8c70edbdecef8cd9f8e91fc727fc53152bd5504f52b4f659ea1312e8e7deb0ac
|
|
BLAKE2b-256 checksum How to use checksums |
8efddaf604a81659cf73612dcfde9cc33fc36d56dc4dac92c7d59d7f4bf1150e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.8
|
Release files / iflow_mcp_kaggle_mcp-0.1.2-py3-none-any.whl
| Download URL | iflow_mcp_kaggle_mcp-0.1.2-py3-none-any.whl |
|---|---|
| Size | 21.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ada6cba69f3b72265f7774f6b05d0d1f8e47373f4e07d4017f0de9729c02f047
|
|
BLAKE2b-256 checksum How to use checksums |
8bcf2005950b125d76e019b07cbcd3b0e7edccaea57f5e79a5f5e43458f15d93
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.8
|
Security for iflow-mcp_kaggle-mcp 0.1.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.