Configure the MCP client

The MCP server allows AI assistants to interact with the Snowplow CLI using the snowplow-cli mcp command.

It can be used with any MCP-compatible client. Below are configuration examples for popular clients:

Claude Desktop

Add the following to your Claude Desktop configuration file, found at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

For direct Snowplow CLI connection:

json

{
  "mcpServers": {
    "snowplow-cli": {
      "command": "snowplow-cli",
      "args": ["mcp"]
    }
  }
}

Using npx:

json

{
  "mcpServers": {
    "snowplow-cli": {
      "command": "npx",
      "args": ["-y", "@snowplow/snowplow-cli", "mcp"]
    }
  }
}

Filesystem access

Claude Desktop requires additional filesystem access to create and modify files.

VS Code

Add to .vscode/mcp.json in your workspace.

For direct Snowplow CLI connection:

json

{
  "servers": {
    "snowplow-cli": {
      "type": "stdio",
      "command": "snowplow-cli",
      "args": ["mcp"]
    }
  }
}

Using npx:

json

{
  "servers": {
    "snowplow-cli": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@snowplow/snowplow-cli", "mcp"]
    }
  }
}

Cursor

Add to .cursor/mcp.json in your workspace:

json

{
  "mcpServers": {
    "snowplow-cli": {
      "command": "snowplow-cli",
      "args": ["mcp", "--base-directory", "."]
    }
  }
}

After adding the configuration, restart the client. The Snowplow CLI MCP tools should be available for use.