LimeSurvey

You run a LimeSurvey MCP Server to centrally manage your LimeSurvey surveys and responses, then connect MCP clients to perform actions like listing surveys, creating surveys, or exporting responses through a consistent, standardized interface.

How to use

To use the LimeSurvey MCP Server, configure an MCP client to connect to your server using the local stdio workflow. You will run a launcher that starts the MCP server process and points it at your LimeSurvey instance with your login credentials. Once running, your MCP client can send requests to manage surveys, questions, responses, and related data in LimeSurvey.

How to install

Prerequisites: ensure you have Python 3.8+ and your preferred runtime tools installed. You will also need a working MCP client capable of launching a local process (stdio) to connect to the server.

Step 1: Prepare the environment. Open a terminal and verify you can run Python.

Step 2: Obtain the MCP server code. Clone the MCP server repository using your usual method to download the server sources to your machine.

Step 3: Install server dependencies. If a dependency file exists, install them using your standard package manager (for Python projects, this is typically pip). Ensure your Python environment is activated before installing dependencies.

Step 4: Configure the server. Create or edit the environment configuration to include your LimeSurvey instance URL, username, and password. These values are sent to the server to authenticate with LimeSurvey.

Step 5: Start the server. Run the command suggested by the project to launch the MCP server locally and keep it running so MCP clients can connect.

Additional content

Configuration details you will need to provide to the server include the URL of your LimeSurvey instance, your LimeSurvey username, and your LimeSurvey password. The example setup shows how these values are supplied to the server through environment variables.

Security tip: store credentials securely and avoid embedding them directly in client configurations or logs. Use environment variables or a secure credential store where possible.

Sample MCP configuration

{
  "mcpServers": {
    "limesurvey_mcp": {
      "command": "/path/to/uv",
      "args": [
        "--directory",
        "/path/to/limesurvey-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "LIMESURVEY_URL": "https://your-limesurvey.example.com/admin/remotecontrol",
        "LIMESURVEY_USERNAME": "your_username",
        "LIMESURVEY_PASSWORD": "your_password"
      }
    }
  }
}

Metadata

This section contains the structured MCP server configuration and environment variables used to connect to LimeSurvey.