What are the requirements to run this server?

You need Python 3.8 or higher, FastAPI, Uvicorn, and other dependencies listed in the `requirements.txt` file.

What is BirdNet-Pi MCP Server?

It's a Python-based server that exposes BirdNet-Pi's bird detection data and functionalities through a Model Context Protocol (MCP) API, allowing easy access and integration.

What credentials does it need?

It reads `MCP_HTTP_HOST` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

BirdNet MCP Server

Exposes BirdNet-Pi data and functionality through a Model Context Protocol (MCP) server.

Remote serverstreamable-httpPython★ 3

What is the BirdNet MCP Server?

Exposes BirdNet-Pi data and functionality through a Model Context Protocol (MCP) server.

What the server does

A Model Context Protocol (MCP) server for BirdNET-Pi integration. Provides tools to query bird detection data, statistics, audio recordings, activity patterns, and reports from a local BirdNET-Pi installation.

Bird detection data retrieval with date and species filtering
Detection statistics and analysis
Audio recording access (base64 or buffer)
Daily activity patterns with hourly breakdowns
HTML and JSON report generation
Dual transport: stdio (default) and streamable-http

Credentials and setup notes

Python 3.10+ - MCP Python SDK >= 1.26.0

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
get_detections	Get bird detections filtered by date range and optional species. - start_date (required): Start date in YYYY-MM-DD format - end_date (required): End date in YYYY-MM-DD format - species (optional): Species name filter (pa
get_stats	Get aggregate detection statistics for a time period. - period (required): day, week, month, or all - min_confidence (optional): Minimum confidence threshold 0.0-1.0 (default: 0.0)
get_audio	Retrieve the audio recording for a specific bird detection. - filename (required): Audio filename from a detection record - format (optional): base64 (default) or buffer
get_activity	Get hourly bird activity patterns for a specific day. - date (required): Date in YYYY-MM-DD format - species (optional): Species name filter
generate_report	Generate a detection report for a date range. - start_date (required): Report start date - end_date (required): Report end date - format (optional): json (default) or html

How to install the BirdNet MCP Server

{
  "mcpServers": {
    "birdnet": {
      "command": "python",
      "args": ["/absolute/path/to/mcp-BirdNET-Pi-server/server.py"]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

Python 3.10+ - MCP Python SDK >= 1.26.0

Variable	Description	Required
MCP_HTTP_HOST	Endpoint or connection string the server talks to.	Optional

Example prompts to try

“Use BirdNet to get detections.”
“Use BirdNet to get stats.”
“Use BirdNet to get audio.”

Frequently asked questions

Key features include filtering bird detections by date and species, providing detection statistics, audio recording access, analyzing daily activity patterns, and generating reports.