Kaggle MCP Server

1# kaggle-mcp-server
2This project provides an MCP (Model Context Protocol) server for interacting with Kaggle from Claude Desktop (or any MCP-compatible client)
3 
4# 🚀 Setup
5# 1. Clone the repository and install dependencies
6     pip install -r requirements.txt
7 
8# 2. Configure Kaggle API credentials
9 
10      Go to your Kaggle account -> Settings
11      
12      Scroll to API section → click Create New API Token.
13      This will download a file called kaggle.json.
14 
15      Place kaggle.json in the following location on your system:
16      
17      Linux/Mac:
18      
19      ~/.kaggle/kaggle.json
20      
21      Windows:
22      
23      C:\Users\<your-username>\.kaggle\kaggle.json
24 
25# 3. Configure Claude Desktop
26 
27     To connect Claude with this MCP server, create or update the file:
28     
29     Claude/claude_desktop_config.json
30     
31     with the following contents:
32     
33     {
34       "mcpServers": {
35         "Kaggle": {
36           "command": "<path-to-your-python-executable>",
37           "args": ["<path-to-your-kaggle-server.py>"]
38         }
39       }
40     }
41     
42     Replace <path-to-your-python-executable> with the path to your Python interpreter (e.g. python or C:/Python/python.exe).
43     
44     Replace <path-to-your-kaggle-server.py> with the path to this repo’s kaggle-server.py file.
45 
46# 📜 Usage
47 
48     Once configured:
49     
50     Start Claude Desktop.
51     
52     Start the Kaggle MCP server (Run kaggle-server.py as a Python File).
53     
54     You can now use MCP tools defined in kaggle-server.py, for example:
55     
56     get_competitions_list: Fetches the list of available Kaggle competitions and returns them in a JSON-friendly format.
57 
58# 🛠️ About the Code
59 
60     kaggle-server.py registers MCP tools using the @mcp.tool() decorator.
61     
62     The server communicates with Claude via MCP and exposes Kaggle API methods.
63     
64     Example tool:
65     
66     @mcp.tool()
67     def get_competitions_list() -> list[dict]:
68         """
69         Fetch the list of available Kaggle competitions.
70         """
71 
72# ✅ Requirements
73 
74      Python 3.10+
75          
76      Kaggle API credentials (kaggle.json)
77          
78      Dependencies listed in requirements.txt
79 
80# 🔒 Security Notes
81 
82     Never commit your kaggle.json file.
83     
84     Ensure the .kaggle folder has restricted permissions.
85