Kaggle MCP

v1.0.0Data Science & MLstable

Connects Claude AI to the Kaggle API through the Model Context Protocol, enabling users to browse competitions, search and download datasets, analyze kernels, and access pre-trained models through natural language interactions.

claude-aikagglemcpmcp-server
Share:
33
Stars
0
Downloads
0
Weekly
0/5

What is Kaggle MCP?

Kaggle MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to connects claude ai to the kaggle api through the model context protocol, enabling users to browse competitions, search and download datasets, analyze kernels, and access pre-trained models through nat...

Connects Claude AI to the Kaggle API through the Model Context Protocol, enabling users to browse competitions, search and download datasets, analyze kernels, and access pre-trained models through natural language interactions.

This server falls under the Data Science & ML and Analytics categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Connects Claude AI to the Kaggle API through the Model Conte

Use Cases

Browse and search Kaggle competitions.
Download datasets and pre-trained models.
Analyze kernels and explore community content.
54yyyu

Maintainer

LicenseMIT License
Languagepython
Versionv1.0.0
UpdatedApr 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx kaggle-mcp

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Kaggle MCP

Kaggle-MCP connects Claude AI to the Kaggle API through the Model Context Protocol, enabling natural language access to Kaggle competitions, datasets, kernels (notebooks), and pre-trained models. Instead of navigating Kaggle's website or writing API scripts, you can ask Claude to find a competition, download its data, explore top kernels, or browse available models — all within your chat session. Data scientists and ML practitioners use it to accelerate dataset discovery and competition research without leaving their AI workflow.

Prerequisites

  • Python 3.8 or newer installed
  • A Kaggle account with API credentials — go to https://www.kaggle.com/settings/account, click 'Create New API Token', and place the downloaded kaggle.json at ~/.kaggle/kaggle.json with permissions set to 600
  • MCP Python SDK 1.6.0 or higher
  • Claude Desktop or another MCP-compatible client
1

Install Kaggle-MCP

Install from the GitHub repository using pip or uv. A setup utility (kaggle-mcp-setup) is included to auto-configure Claude Desktop.

# With pip
pip install git+https://github.com/54yyyu/kaggle-mcp.git

# Or with uv (recommended)
uv pip install git+https://github.com/54yyyu/kaggle-mcp.git
2

Place your Kaggle API credentials

Move the kaggle.json downloaded from your Kaggle account settings into the expected location and restrict its permissions.

mkdir -p ~/.kaggle
mv ~/Downloads/kaggle.json ~/.kaggle/kaggle.json
chmod 600 ~/.kaggle/kaggle.json
3

Run the setup utility to configure Claude Desktop automatically

kaggle-mcp-setup locates your Claude Desktop config file and adds the mcpServers entry for you. Alternatively, add the entry manually as shown in the examples section.

kaggle-mcp-setup
4

Restart Claude Desktop

After the configuration is written, restart Claude Desktop so it picks up the new server entry.

5

Authenticate and start exploring Kaggle

Claude will use the credentials from ~/.kaggle/kaggle.json automatically. You can also authenticate inline with the authenticate tool if you want to use a different account.

Kaggle MCP Examples

Client configuration

Manual configuration for claude_desktop_config.json if you prefer not to use the setup utility.

{
  "mcpServers": {
    "kaggle": {
      "command": "kaggle-mcp"
    }
  }
}

Prompts to try

Use these prompts with Claude Desktop to browse and download Kaggle resources.

- "List the currently active Kaggle competitions"
- "Show me the top 10 entries on the Titanic competition leaderboard"
- "Find datasets about climate change with more than 1000 downloads"
- "Download the Boston housing dataset"
- "Search for kernels about transformer fine-tuning in NLP"
- "Show me pre-trained image classification models available on Kaggle"

Troubleshooting Kaggle MCP

401 Unauthorized when calling Kaggle tools

Verify that ~/.kaggle/kaggle.json exists, is readable (chmod 600), and contains valid 'username' and 'key' fields. You can also pass credentials directly by asking Claude to call the authenticate tool with your username and API key.

'kaggle-mcp' command not found after installation

The console script may not be on your PATH. Run 'which kaggle-mcp' or 'pip show kaggle-mcp' to locate the install directory, then add it to PATH. Using uv or pipx ensures the script is properly symlinked.

Dataset download is slow or fails midway

Large Kaggle datasets can take time. Ensure you have accepted the dataset's terms of use on the Kaggle website — some datasets require explicit acceptance before the API will serve them.

Frequently Asked Questions about Kaggle MCP

What is Kaggle MCP?

Kaggle MCP is a Model Context Protocol (MCP) server that connects claude ai to the kaggle api through the model context protocol, enabling users to browse competitions, search and download datasets, analyze kernels, and access pre-trained models through natural language interactions. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Kaggle MCP?

Follow the installation instructions on the Kaggle MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Kaggle MCP?

Kaggle MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Kaggle MCP free to use?

Yes, Kaggle MCP is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Data Science & ML MCP Servers

Explore all data science & ml servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "kaggle-mcp": { "command": "npx", "args": ["-y", "kaggle-mcp"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Kaggle MCP?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides