Connect Artemis to Claude Code

Connect Claude Code to your Artemis account to ask about projects, financing, roof measurements, and your team. Artemis uses MCP (Model Context Protocol), a standard that lets an AI assistant use a product's tools. Sign in through your browser with your Artemis account. You do not need an API key, and you should never paste a password or token into a chat.

Choose an environment

Use production for your real Artemis projects:

https://sales-api.artemis.solar/external/v2/mcp

Use the sandbox if you have an Artemis sandbox account:

https://sales-sandbox-api.artemis.solar/external/v2/mcp

https://docs.artemis.solar/mcp searches documentation only, not your Artemis projects.

Connect with Claude Code

Have Claude Code installed and an Artemis account for the environment you choose. The setup below was checked with Claude Code 2.1.325 against a test environment.

1. Add Artemis

Run this command in your terminal for production:

claude mcp add --transport http --scope user artemis https://sales-api.artemis.solar/external/v2/mcp

For the sandbox, run this command instead:

claude mcp add --transport http --scope user artemis https://sales-sandbox-api.artemis.solar/external/v2/mcp

This saves the connection for your user across projects on this computer.

2. Sign in

claude mcp login artemis

Your browser opens Artemis. If you are signed out, enter your email and password on the Welcome Back page and select Sign In. If the browser does not open, copy the address that Claude Code prints and open it in your browser.

3. Choose permissions

The consent page says Connect Claude Code (artemis) to Artemis. Check the email and organization under Signed in as before continuing. Under Access requested, Artemis says: Choose permissions for this connection, limited to your Artemis access.

  • All selects the available permissions and is selected by default.
  • Read Only selects only read permissions. Use it to try Artemis without allowing changes, even as an admin.
  • Clear All clears the selection so you can choose individual permissions.

The available permissions depend on your Artemis access. The connection cannot grant Claude Code more access than you have. Select Allow access to continue, or Cancel to decline.

4. Check the connection

The browser shows Authentication successful and You can close this tab and return to Claude Code. Check the connection in your terminal:

claude mcp list

Artemis should show ✔ Connected, rather than ! Needs authentication. Then start Claude Code and try a prompt below.

Alternative: install the Artemis plugin

The public plugin repository is not available yet. Use the direct connection above until it is published.

The plugin will add the production Artemis connection and task skills, which are reusable instructions for common Artemis requests. Use it instead of the direct connection, not both. Use the direct connection above for the sandbox.

Once the repository is public, run these commands in your terminal:

claude plugin marketplace add monalee-inc/artemis-skills
claude plugin install artemis@artemis
claude mcp login plugin:artemis:artemis

The consent heading is Connect Claude Code (plugin:artemis:artemis) to Artemis. Check your account, choose permissions, and select Allow access as described above. Run claude mcp list and look for ✔ Connected beside plugin:artemis:artemis. Start a new Claude Code session to use the plugin.

To disconnect and remove the plugin and its marketplace, sign out first:

claude mcp logout plugin:artemis:artemis
claude plugin marketplace remove artemis

Try these first

These prompts ask for information, not changes. Replace <address> with a project address you can access. Available answers depend on your permissions and the project's data.

Sales reps

Using Artemis, list my 10 most recently updated projects
with customer name, address and status.
Then tell me which 3 need a follow-up first, and why.
Using Artemis, summarize the project at <address>:
status history, system size, price, and financing options.
Keep it short enough to read before a call.
Using Artemis, compare the financing options for the
project at <address> and explain each monthly cost
in plain words.

Roofing reps

Using Artemis, give me the roof measurements for the
project at <address>: total squares, predominant pitch,
and the ridge, hip, valley and rake lengths.

Roof measurements require access to roofing measurements in your organization.

Admins

Using Artemis, list every team with its active pricing,
and point out teams that have no pricing set.
Using Artemis, check which installers are not ready
and list what each one is missing.
Using Artemis, list invites that are still pending,
with the person and the date sent.

Disconnect

For the direct connection, sign out before removing the saved server:

claude mcp logout artemis
claude mcp remove artemis --scope user

Signing out first lets Claude Code request token revocation, rather than only deleting its saved connection. Your Artemis account and projects are not deleted.

Coming soon

Codex and Cursor CLI setup guides are coming soon, after their sign-in fixes are verified.