Connect Claude Desktop

Once setup is done, Nevios tools show up in Claude Desktop's 🔌 menu and you can say things like:

"Search my notes for everything related to the Q4 launch and summarise it into a new note in the Marketing folder."

Claude will chain search_notes → get_note × N → create_note in a single step.

1. Mint a key

In the dashboard create a key for Claude at Settings → Account → API keys. Recommended scopes to start:

• workspaces:read
• notes:read notes:write
• files:read
• inbox:read

Add more as you decide what the AI should be allowed to do.

2. Open the config

# macOS
open ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Windows
notepad %APPDATA%\Claude\claude_desktop_config.json

# Linux
nano ~/.config/Claude/claude_desktop_config.json

3. Add Nevios

{
  "mcpServers": {
    "nevios": {
      "command": "uv",
      "args": [
        "--directory", "/absolute/path/to/Accounting/apps/mcp",
        "run", "python", "-m", "nevios_mcp.server"
      ],
      "env": {
        "NEVIOS_API_URL": "https://api.nevios.io",
        "NEVIOS_WEB_URL": "https://nevios.io",
        "NEVIOS_API_KEY": "nev_pat_...",
        "NEVIOS_WORKSPACE_ID": "0c71cc52-6ad1-4c32-b8c3-979ad1f2a5b4",
        "NEVIOS_WORKSPACE_SLUG": "vasky",
        "NEVIOS_COMPANY_ID": "1"
      }
    }
  }
}

NEVIOS_WORKSPACE_ID is in the list_workspaces output (or your dashboard URL — /<slug>/...).

4. Restart Claude Desktop

After restart you'll see a 🔌 icon in the bottom-right of the chat. Click it → Nevios tools are there. Try:

"List my five most recent notes."

Safety

Claude always asks for confirmation before writes (create / update / delete). If you want auto-approval for safe reads, set it in Claude Desktop preferences → Tools → Auto-approve. Never enable auto-approve for *:write or *:admin scopes.

Troubleshooting

• Server failed to start → check the absolute path in --directory. uv must be on PATH.
• 401 Unauthorized → the key has expired or been revoked.
• 403 missing_scope → Claude is trying an action that's outside the granted scopes. Either add the scope or tell Claude not to do that specific thing.