Connect an AI Agent

Tabsdata's agentic workflow uses an MCP server so a coding agent builds and runs your workflows for you. Install it into your agent before continuing to QuickStart. Claude Code and Codex are currently supported.

Step 1Install the MCP server

Start the agent from a shell whose virtual environment has Tabsdata installed.

Temporary, for 2.0.0

The MCP server needs tabsdata-agent, which ships as its own package and is not yet pulled in by tabsdata[all]. For 2.0.0 it also has to be installed from the Tabsdata package index with the version pinned.

Set the index first. This is needed whichever installer you use:

export PIP_EXTRA_INDEX_URL=https://pypi.tabsdata.com/simple/
export UV_INDEX=https://pypi.tabsdata.com/simple/
export UV_INDEX_STRATEGY=unsafe-best-match

Then install the Tabsdata agent if you have not done so yet:

uv

uv pip install tabsdata-agent==2.0.0

pip

pip install tabsdata-agent==2.0.0

Install Tabsdata covers this as part of the full install, so skip this if you followed that page. These additional steps will not be required once Tabsdata 2.0.0 is on PyPI

Claude Code

claude mcp add tabsdata -- python -m tabsdatak.ag.mcp -

Codex

Linux / macOS

codex mcp add tabsdata -- "$(python -c 'import sys; print(sys.executable)')" -m tabsdatak.ag.mcp -

Windows PowerShell

codex mcp add tabsdata -- (python -c "import sys; print(sys.executable)") -m tabsdatak.ag.mcp -

Windows cmd.exe

for /f "delims=" %i in ('python -c "import sys; print(sys.executable)"') do codex mcp add tabsdata -- "%i" -m tabsdatak.ag.mcp -

Step 2Using the agent

You need an active session with the Tabsdata server before starting your agent. Log in, then start it from the same terminal:

Claude Code

tdk login --server localhost --user admin --password tabsdata
claude

Codex

tdk login --server localhost --user admin --password tabsdata
codex

The agent authenticates through your session, so it can only do what you're authorized to do.

Next: Run Your First Data Integration. Build a working flow end to end.