larkx MCP Server for Claude Code

How it works

Claude Code's VS Code extension reads a file called .mcp.json in your project root. Each entry tells the extension how to spawn an MCP server. When you open the project, Claude Code asks for approval, then connects.

1. 1

   Make sure larkx is installed

   bashcopy

   npm install -g larkx
   larkx --version

2. 2

   Create .mcp.json (or let init do it)

   If you ran larkx init, this file already exists. Otherwise create it manually in the project root:

   .mcp.jsoncopy

   {
     "mcpServers": {
       "larkx": {
         "command": "larkx",
         "args": ["mcp"]
       }
     }
   }

   If larkx is not on your PATH, point at the bin directly:

   jsoncopy

   {
     "mcpServers": {
       "larkx": {
         "command": "node",
         "args": ["C:\\path\\to\\larkx\\bin\\larkx.js", "mcp"]
       }
     }
   }

3. 3

   Reload VS Code

   bashcopy

   Ctrl+Shift+P → Developer: Reload Window

   (macOS: Cmd+Shift+P)

4. 4

   Approve the server

   Claude Code will show a prompt asking you to approve the larkx MCP server for this project. Click Allow. Once approved it auto-connects in future sessions.

5. 5

   Verify

   Open the Claude Code chat and ask:

   "Which MCP servers do you have?"

   The response should include larkx with 6 tools listed.

Common scopes

Next steps

• Global setup for terminal Claude Code
• Set up Cursor, Copilot, Codex, Gemini
• UserPromptSubmit hook, make Claude always use MCP first