Skip to content
MCP server

Quirna

Ask a human before your agent acts: approval requests decided on a phone.

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.2
Listing updated
5 days ago

About Quirna

Quirna is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add mcp --env QUIRNA_API_KEY='<QUIRNA_API_KEY>' -- npx -y @quirna/mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@quirna/mcp"
      ],
      "env": {
        "QUIRNA_API_KEY": "<QUIRNA_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@quirna/mcp"
      ],
      "env": {
        "QUIRNA_API_KEY": "<QUIRNA_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@quirna/mcp"
      ],
      "env": {
        "QUIRNA_API_KEY": "<QUIRNA_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@quirna/mcp"
      ],
      "env": {
        "QUIRNA_API_KEY": "<QUIRNA_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@quirna/mcp"
      ],
      "env": {
        "QUIRNA_API_KEY": "<QUIRNA_API_KEY>"
      }
    }
  }
}

Configuration

  • QUIRNA_API_KEYKey of a System registered in the Quirna Console (Users → Systems).Required
  • QUIRNA_REQUESTER_IDWho the Console shows as having asked. Defaults to "mcp".
  • QUIRNA_REQUESTER_NAMEDisplay name for the requester. Defaults to "AI agent".
  • QUIRNA_ENVIRONMENTEnvironment used when a tool call names none. Empty means the org default.
  • QUIRNA_WAIT_MSHow long a tool call waits for a decision before returning pending. Defaults to 90000.
  • QUIRNA_BASE_URLOverride the Quirna API URL. Leave unset.

Pricing

Open source

Prices change. Check quirna.com before you buy.

Quirna FAQ

Is Quirna free?

Yes. Quirna is open source, so you can use and self-host it for free.

How do I add Quirna to Claude Code?

Run this command in your terminal: claude mcp add mcp --env QUIRNA_API_KEY='<QUIRNA_API_KEY>' -- npx -y @quirna/mcp