Companies House CLI and MCP

Read the UK Companies House public register from your terminal, your scripts, or an AI assistant. Search companies, read their records, trace ownership, pull filings and download the filed documents themselves.

Everything runs on your own free API key. No hosted backend, no shared key, no proxy — requests go from your machine straight to Companies House.

Documentation: companies-house.uk

Pick your route

In an AI assistant — Claude Code, Claude Desktop, Codex, Cursor, Zed:

npx -y companies-house-mcp

Set COMPANIES_HOUSE_API_KEY in the client’s config. Full setup for each client: companies-house.uk/mcp.

In the terminal — the ch command:

npm install -g companies-house-cli
ch config set-key your-key-here
ch report 00445790

Full reference: companies-house.uk/cli.

On your own server — an optional Cloudflare Worker you deploy into your own account, so Claude Code can reach it remotely. See companies-house.uk/self-hosting, or the deployment guide.

Get a free API key at developer.company-information.service.gov.uk. It takes about a minute.

What you can do

Find a company — search_companies / ch search by name, with filters for status, type, incorporation date, location and SIC code. search_officers / ch search-officers finds people across the whole register.

Read its record — get_company_profile / ch profile for status, addresses, SIC codes and filing dates. get_charges, get_insolvency, get_company_registers, get_exemptions and get_uk_establishments for the rest.

Trace people and ownership — get_officers / ch officers for who is in post, get_appointments and officer_network for everywhere one person is appointed, get_ownership / ch ownership for persons with significant control, and get_officer_disqualifications for the disqualified directors register.

Read the filings — get_filings / ch filings for the filing history, get_filing_document for one filing in detail, and download_filing_document / ch document for the filed PDF itself.