"meta","1",{"name":"viewport","content":"width=device-width, initial-scale=1"}]] b:null 28:I[60719,["7626","static/chunks/f6ab4fea-4425dae3da7674a3.js","8548","static/chunks/b27dc69b-e5acb70cd9d66ddf.js","5232","static/chunks/5232-db5923cda78a4960.js","6465","static/chunks/6465-6b79f1dc957ae3f4.js","9388","static/chunks/9388-d1a745fd53a10850.js","4902","static/chunks/4902-40271c136eb736f1.js","1508","static/chunks/1508-abbc58115cbb4fd0.js","6125","static/chunks/6125-6f7cbc86df4f2503.js","7771","static/chunks/7771-66979ce602088329.js","7660","static/chunks/7660-f5d56ac6a9ee6cc8.js","4147","static/chunks/4147-ef3df161a800b88b.js","9783","static/chunks/9783-e1d5b54e9718b38b.js","8084","static/chunks/8084-f1229cc5d0501fe0.js","2024","static/chunks/2024-e03e13f5faa34f45.js","7796","static/chunks/app/%5Blocale%5D/(default)/server/%5Bname%5D/%5Bauthor_name%5D/page-c3a3facf548ee943.js"],"default"] 29:T100f,

# IcebergMCP 🚀 AI-native Lakehouse Integration [![PyPI - Version](https://img.shields.io/pypi/v/iceberg-mcp.svg)](https://pypi.org/project/iceberg-mcp) [![License](https://img.shields.io/github/license/ryft-io/iceberg-mcp)](https://github.com/ryft-io/iceberg-mcp/blob/main/LICENSE)

IcebergMCP is a [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server that allows interacting with your [Apache Iceberg](https://iceberg.apache.org/) Lakehouse via natural language in Claude, Cursor, or any other MCP client.

## Table of Contents - [Installation](#installation) - [Prerequisites](#prerequisites) - [Claude](#claude) - [Cursor](#cursor) - [Configuration](#configuration) - [Available Tools](#available-tools) - [Examples](#examples) - [Limitations & Security Considerations](#limitations--security-considerations) - [Contributing](#contributing) ## Installation ### Prerequisites - Iceberg catalog managed in AWS Glue - AWS profile configured on the machine, with access to the catalog - `uv` package manager - install via `brew install uv` or see [official installation guide](https://docs.astral.sh/uv/getting-started/installation/) ### Claude 1. Inside Claude, go to Settings > Developer > Edit Config > claude_desktop_config.json 2. Add the following: ```json { "mcpServers": { "iceberg-mcp": { "command": "uv", // If uv can't be found, replace with full absolute path to uv "args": [ "run", "--with", "iceberg-mcp", "iceberg-mcp" ], "env": { "ICEBERG_MCP_PROFILE": "" } } } } ``` ### Cursor 1. Inside Cursor, go to Settings -> Cursor Settings -> MCP -> Add new global MCP server 2. Add the following: ```json { "mcpServers": { "iceberg-mcp": { "command": "uv", // If uv can't be found, replace with full absolute path to uv "args": [ "run", "--with", "iceberg-mcp", "iceberg-mcp" ], "env": { "ICEBERG_MCP_PROFILE": "" } } } } ``` ## Configuration Environment variables can be used to configure the AWS connection: - `ICEBERG_MCP_PROFILE` - The AWS profile name to use. This role will be assumed and used to connect to the catalog and the object storage. If not specified, the default role will be used. - `ICEBERG_MCP_REGION` - The AWS region to use. This is used to determine the catalog and object storage location. `us-east-1` by default. ## Available Tools The server provides the following tools for interacting with your Iceberg tables: - `get_namespaces`: Gets all namespaces in the Iceberg catalog - `get_iceberg_tables`: Gets all tables for a given namespace - `get_table_schema`: Returns the schema for a given table - `get_table_properties`: Returns table properties for a given table, like total size and record count - `get_table_partitions`: Gets all partitions for

Iceberg MCP

Tools