How to add Atlan MCP Server to Claude Desktop

Search, govern, and manage Atlan data catalog assets from AI agents via the Model Context Protocol. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 33★ · stdio · apikey

Claude Desktop config for Atlan MCP Server

uvx atlan-mcp-server

{
  "mcpServers": {
    "atlan-mcp-server": {
      "command": "uvx",
      "args": [
        "atlan-mcp-server"
      ],
      "env": {
        "ATLAN_API_KEY": "<YOUR_API_KEY>",
        "ATLAN_BASE_URL": "https://<YOUR_INSTANCE>.atlan.com",
        "ATLAN_AGENT_ID": "<YOUR_AGENT_ID>"
      }
    }
  }
}

Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.

Setup steps

1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
2Paste the Atlan MCP Server config below under the top-level "mcpServers" key.
3Fill in any placeholder secrets (API keys, paths) in the snippet.
4Save the file, then fully quit and reopen Claude Desktop.
5Open a chat and confirm Atlan MCP Server's tools appear under the 🔌 tools menu.

Before you start

An Atlan instance and an Atlan API key (ATLAN_API_KEY)
Your Atlan instance base URL (ATLAN_BASE_URL, e.g. https://<your-instance>.atlan.com)
Docker (for the Docker install method) OR uv / Python 3.11+ (for the uvx install method)

What Atlan MCP Server can do in Claude Desktop

search_assets

Search for assets based on conditions.

get_assets_by_dsl

Retrieve assets using a DSL query.

traverse_lineage

Retrieve lineage for an asset.

update_assets

Update asset attributes (user description and certificate status).

create_glossaries

Create glossaries.

create_glossary_categories

Create glossary categories.

create_glossary_terms

Create glossary terms.

create_dq_rules

Create data quality rules on Table, View, MaterialisedView, or SnowflakeDynamicTable assets (column-level, table-level, custom SQL).

Security

Requires an Atlan API key (ATLAN_API_KEY) and your instance base URL (ATLAN_BASE_URL) passed as environment variables; store these securely and avoid committing them. The server supports a RESTRICTED_TOOLS environment variable to block specific tools (e.g. for read-only access or to disable raw DSL/SQL queries) — recommended for least-privilege and shared/production deployments. The local server is deprecated and in maintenance-only mode; the vendor recommends the hosted endpoint at mcp.atlan.com/mcp.

Atlan MCP Server + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Atlan MCP Server config there under the "mcpServers" key and restart the client.

Is Atlan MCP Server safe to use with Claude Desktop?

Do I need Python installed?

It depends on the install method. With Docker (recommended) no Python is needed on the host — the container includes everything. With uv, a Python runtime is required, but uv will automatically download and manage Python 3.11+ for you. The server is implemented in Python and requires Python 3.11+ to run.

Which MCP clients are supported?

The README documents mcpServers config blocks for Claude Desktop and Cursor over stdio. SSE and streamable-http transports are also supported for remote/web deployments.

Can I restrict which tools are exposed?

Yes. Set the RESTRICTED_TOOLS environment variable to a comma-separated list of tool names to hide and block them — useful for read-only access or disabling raw DSL/SQL queries. If unset, all tools are available by default.

View repo Full Atlan MCP Server page