Nevent AI in Claude Desktop

Claude Desktop loads MCP servers from a JSON configuration file. This file is edited manually — Claude Desktop has no graphical interface for managing MCP servers.

Configuration file location

macOS
Windows

~/Library/Application Support/Claude/claude_desktop_config.json

%APPDATA%\Claude\claude_desktop_config.json

Equivalent to: C:\Users\YourUser\AppData\Roaming\Claude\claude_desktop_config.json

If the file does not exist, create it. If it already exists, add the nevent block to the mcpServers object.

Minimal configuration (stdio mode)

{
  "mcpServers": {
    "nevent": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-nevent/dist/index.js"],
      "env": {
        "NEVENT_JWT_TOKEN": "your_nevent_jwt_token"
      }
    }
  }
}

Replace /absolute/path/to/mcp-nevent/dist/index.js with the real path where you have the package cloned and compiled.

Using npx (without cloning the repo)

If you prefer not to clone the repo, you can use npx:

{
  "mcpServers": {
    "nevent": {
      "command": "npx",
      "args": ["mcp-nevent"],
      "env": {
        "NEVENT_JWT_TOKEN": "your_nevent_jwt_token"
      }
    }
  }
}

Global installation (recommended for frequent use)

Install the package once globally:

npm install -g mcp-nevent

Then in the Claude Desktop configuration:

{
  "mcpServers": {
    "nevent": {
      "command": "mcp-nevent",
      "env": {
        "NEVENT_JWT_TOKEN": "your_nevent_jwt_token"
      }
    }
  }
}

With explicit operation mode

To enable writes, add NEVENT_OPERATION_MODE:

{
  "mcpServers": {
    "nevent": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-nevent/dist/index.js"],
      "env": {
        "NEVENT_JWT_TOKEN": "your_nevent_jwt_token",
        "NEVENT_OPERATION_MODE": "STANDARD"
      }
    }
  }
}

Valid values are READ_ONLY (default), STANDARD and FULL. See the description of each mode in the permissions and security guide.

Path with system environment variables (macOS)

On macOS, Claude Desktop does not inherit shell environment variables. If you have the token in your .zshrc or .bashrc, you must include it explicitly in the JSON or use the full path to the node binary:

{
  "mcpServers": {
    "nevent": {
      "command": "/usr/local/bin/node",
      "args": ["/Users/your_user/projects/mcp-nevent/dist/index.js"],
      "env": {
        "NEVENT_JWT_TOKEN": "your_token_here"
      }
    }
  }
}

To find the path to node on your system:

which node

Verify it works

Save the changes to claude_desktop_config.json
Fully close Claude Desktop
Open Claude Desktop again
Start a new conversation and type:

What Nevent tools do you have available?

Claude Desktop will show the available tools if the MCP server is loaded correctly. If it does not respond with Nevent tools, check the troubleshooting guide.