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.

Get the whole picture at once — company_report / ch report reads the main records in a single call. due_diligence_check / ch check screens a company against the register and reports the entries a reviewer would want to look at.

Full parameter reference: companies-house.uk/tools.

What this is not

Companies House records what companies file. It carries out basic completeness checks but does not verify that the information is accurate.

So nothing here is a verification, a credit check, a sanctions or politically-exposed-person screening, or a clearance decision. due_diligence_check is a screening summary: it tells you what is on the register and what it could not check. It never concludes that a company is sound. An absence of adverse entries means nothing adverse has been filed.

The register also does not cover trading performance, litigation, or beneficial ownership held outside the persons-with-significant-control regime. Identity verification for existing directors and PSCs is still being rolled out under the Economic Crime and Corporate Transparency Act, so a name on the register does not mean the person behind it has been ide

... View full README on GitHub