Kaggle MCP Server

A Model Context Protocol (MCP) server for interacting with Kaggle competitions through Claude or other compatible AI assistants.

📖 Learn More

Want to understand the full potential of this server? Check out the detailed article:

AI-Powered Data Science Revolution: How Kaggle MCP Server Transforms AI Capabilities

Prerequisites

• Node.js 18 or higher
• TypeScript
• Kaggle CLI installed (pip install kaggle)
• Kaggle API credentials configured

Authentication Setup

There are two ways to authenticate with the Kaggle API:

Option 1: Using a kaggle.json file (Standard approach)

1. Install the Kaggle CLI:

pip install kaggle

2. Go to https://www.kaggle.com/account and click “Create New API Token”
3. This will download a kaggle.json file with your credentials
4. Create a .kaggle directory in your home folder (if it doesn’t exist)

# On Linux/Mac
mkdir -p ~/.kaggle

# On Windows (PowerShell)
New-Item -ItemType Directory -Force -Path "$HOME\.kaggle"

5. Move the downloaded kaggle.json file to the .kaggle directory:

# On Linux/Mac
mv ~/Downloads/kaggle.json ~/.kaggle/
chmod 600 ~/.kaggle/kaggle.json  # Set permissions

# On Windows (PowerShell)
Move-Item -Path "$HOME\Downloads\kaggle.json" -Destination "$HOME\.kaggle\kaggle.json"

Option 2: Using Claude for Desktop Configuration (Simpler)

You can directly add your Kaggle credentials to your claude_desktop_config.json file:

{
  "mcpServers": {
    "kaggle": {
      "command": "node",
      "args": ["/path/to/build/index.js"],
      "env": {
        "KAGGLE_USERNAME": "your-kaggle-username",
        "KAGGLE_KEY": "your-kaggle-api-key"
      }
    }
  }
}

Replace your-kaggle-username and your-kaggle-api-key with your actual Kaggle credentials.

Installation

1. Clone this repository
2. Install dependencies:

npm install

3. Build the project:

npm run build

Usage

Running the server

npm start

Or directly:

node build/index.js

Connecting with Claude for Desktop

Add the following configuration to your claude_desktop_config.json file (use the absolute path to your clone):

{
  "mcpServers": {
    "kaggle": {
      "command": "node",
      "args": ["/absolute/path/to/kaggle-MCP/build/index.js"]
    }
  }
}

Add the env block from Option 2 above if you aren’t using kaggle.json.

Example Queries

Once connected to Claude, you can ask questions like:

• “Show me the active Kaggle competitions”
• “Search for image classification competitions”
• “Download the files for the Titanic competition”
• “Submit my predictions.csv file to the housing-prices competition with the message ‘Random forest model’”