Skip to main content

01 · Install

Add the marketplace, then install Lucy.

Requires Claude Code 2.1.231 or newer. Check your version with claude --version.

Install from your terminal

CLI
  1. Add the Lucy marketplace and install the plugin:

    claude plugin marketplace add ezardev-team/lucy-claude-plugins
    claude plugin install lucy@lucydata
  2. If Claude Code was already open, run /reload-plugins or start a new session so the plugin loads.

02 · Log in

Log in once with your Lucy account.

The login lasts 30 days. There is no client secret to copy or store.

Authenticate in Claude Code

/mcp
  1. In Claude Code, open /mcp.
  2. Select plugin:lucy:lucy-rag and choose Authenticate.
  3. Log in with your Lucy account in the browser window that opens.
  4. When the browser shows Authentication successful, return to Claude Code.

Prefer to be guided?

setup skill

Say “Connect me to Lucy” or run /lucy:lucy-mcp-setup. The setup skill walks you through the same steps.

03 · Ask

Name the company. Ask in plain language.

Mention the company and the filing or period you care about. Claude calls Lucy and answers from the passages it returns.

Example questionFiling
Summarize the main risk factors in NVIDIA's latest 10-K.10-K · Item 1A
What did Apple say about AI in its most recent 10-Q?10-Q
Compare Microsoft's and Alphabet's cloud revenue disclosures.10-K
  • Name the company and the filing or period.
  • Follow-up questions keep the same context.
  • Complex questions can take 30–120 seconds.
  • If Lucy isn't used automatically, say “Search with Lucy for …”.
  • Claude answers from the filing passages Lucy returns and keeps original filing text separate from derived analysis.
  • Claude does not give investment advice.

04 · The setup skill

Something looks wrong? Run the setup skill.

/lucy:lucy-mcp-setup checks the connection, walks you through login, and verifies that Lucy works. Run it anytime.

/lucy:lucy-mcp-setup

05 · Access

Searches need an approved account.

Lucy for Claude Code requires a Lucy account approved for MCP access. To request access, email help@lucydata.ai with your account email. Without approval, login works but searches return 401.

06 · Troubleshooting

Common problems and fixes.

SymptomFix
plugin:lucy:lucy-rag is not listed in /mcpRun /reload-plugins or start a new session.
redirect_mismatch on the login pageUpdate Claude Code to 2.1.231 or newer.
Login never returns from the browserAnother process is using port 8088. Find it with lsof -nP -iTCP:8088 -sTCP:LISTEN.
Logged in, but tool calls return 401Your account isn't approved yet. Email help@lucydata.ai.
Lucy tools are listed twiceRemove an older manual registration: claude mcp remove lucy-rag -s user

07 · Update or uninstall

Keep the plugin current.

Update

CLI
claude plugin marketplace update lucydata
claude plugin update lucy@lucydata

Uninstall

CLI
claude plugin uninstall lucy@lucydata

08 · More

Using Claude Desktop or claude.ai?

Use the Lucy SEC filings search connector instead of the plugin. The plugin's source is on GitHub.