Setting up Meticulous for agents

Connect your coding agent to Meticulous so it can review test runs, inspect diffs, check coverage, and trigger new runs. Agents can connect through the hosted MCP server or the CLI, which offer the same operations. Or hand your agent the agent-addressed version of this page and let it set itself up.

Individual setup

MCP

Where available, install the Meticulous plugin: it connects the MCP server and adds our skills in one go.

Run in Claude Code:

/plugin marketplace add alwaysmeticulous/skills
/plugin install meticulous@meticulous

Then type /mcp, select meticulous and choose Authenticate.

To keep the plugin up to date, type /plugin, go to Marketplaces, select meticulous and choose Enable auto-update.

MCP only: add Meticulous from the Claude directory. It's available in Claude Code too when you're logged in with your Claude account.

CLI

Install the CLI, log in, and add the skills:

npm install --global @alwaysmeticulous/cli@latest
meticulous auth login
npx skills add alwaysmeticulous/skills --skill "*" --agent claude-code --agent codex --agent cursor -y

See CLI commands for token-based authentication and the command reference.

Org-wide setup

Choosing an approach

The steps above set up Meticulous for a single user. To roll it out to your whole team, there are two approaches:

OAuth-based connectors authenticate each user individually — an admin adds a shared connector once, then every team member authenticates themselves the first time they use it.
A project API token authenticates everyone centrally — configured once by an admin, with no individual login. This is also the option for agent platforms that take a fixed credential instead of a login (e.g. Claude Tag).

To use a project API token, select the project below, then copy the token (careful: grants access to recorded sessions!):

<API_TOKEN>

MCP

Go to Organization settings > Connectors > Add, and add Meticulous from the directory, or a custom connector with URL https://app.meticulous.ai/api/mcp. This covers both Claude and Claude Code; each member then clicks Connect once.

Skills

To give everyone working in a repository the skills, whichever agent they use, install them into the repository and commit the result:

npx skills add alwaysmeticulous/skills --skill "*" --agent claude-code --agent codex --agent cursor -y

Run the same command again to update them, or let a scheduled GitHub Action open a pull request whenever they change: