kaggle-mcp-server
This project provides an MCP (Model Context Protocol) server for interacting with Kaggle from Claude Desktop (or any MCP-compatible client)
🚀 Setup
1. Clone the repository and install dependencies
pip install -r requirements.txt
2. Configure Kaggle API credentials
Go to your Kaggle account -> Settings
Scroll to API section → click Create New API Token. This will download a file called kaggle.json.
Place kaggle.json in the following location on your system:
Linux/Mac:
~/.kaggle/kaggle.json
Windows:
C:\Users\<your-username>\.kaggle\kaggle.json
3. Configure Claude Desktop
To connect Claude with this MCP server, create or update the file:
Claude/claude_desktop_config.json
with the following contents:
{ "mcpServers": { "Kaggle": { "command": "<path-to-your-python-executable>", "args": ["<path-to-your-kaggle-server.py>"] } } }
Replace <path-to-your-python-executable> with the path to your Python interpreter (e.g. python or C:/Python/python.exe).
Replace <path-to-your-kaggle-server.py> with the path to this repo’s kaggle-server.py file.
📜 Usage
Once configured:
Start Claude Desktop.
Start the Kaggle MCP server (Run kaggle-server.py as a Python File).
You can now use MCP tools defined in kaggle-server.py, for example:
get_competitions_list: Fetches the list of available Kaggle competitions and returns them in a JSON-friendly format.
🛠️ About the Code
kaggle-server.py registers MCP tools using the @mcp.tool() decorator.
The server communicates with Claude via MCP and exposes Kaggle API methods.
Example tool:
@mcp.tool() def get_competitions_list() -> list[dict]: """ Fetch the list of available Kaggle competitions. """
✅ Requirements
Python 3.10+
Kaggle API credentials (kaggle.json)
Dependencies listed in requirements.txt
🔒 Security Notes
Never commit your kaggle.json file.
Ensure the .kaggle folder has restricted permissions.
