Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
LOGITECH_SYNC_ORG_IDYesRequired organisation ID from Logitech Sync Portal.
LOGITECH_SYNC_CA_FILENoOptional custom CA bundle.
LOGITECH_SYNC_KEY_FILENoPrivate key path; an absolute path is recommended.client-certificate/privateKey.pem
LOGITECH_SYNC_CERT_FILENoClient certificate path; an absolute path is recommended.client-certificate/certificate.pem
LOGITECH_SYNC_TRUST_ENVNoExplicitly allow HTTPX environment proxies and CA settings.false
LOGITECH_SYNC_MAX_RETRIESNoBounded retries for 429/502/503/504 and transport errors.3
LOGITECH_SYNC_API_BASE_URLNoDocumented API server; override only for administration or testing.https://api.sync.logitech.com/v1
LOGITECH_SYNC_FIXTURE_FILENoOffline fixture mode for tests and evaluations.
LOGITECH_SYNC_TIMEOUT_SECONDSNoOverall timeout for one attempt.30
LOGITECH_SYNC_CACHE_TTL_SECONDSNoShort in-memory cache to reduce quota usage.60
LOGITECH_SYNC_MIN_REQUEST_INTERVAL_SECONDSNoMinimum interval between network attempts.1

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
logitech_sync_check_connectionA

Verify live mTLS access, or validate the configured offline fixture.

    Makes exactly one minimal GET request with ``limit=1`` and an empty projection, so only
    a place id can be returned. In fixture mode no network connection or mTLS handshake is
    attempted, and the result says so explicitly. It does not modify Logitech Sync. Use this
    first after setup.

    Returns a structured success envelope plus Markdown/JSON text. Configuration, TLS, 403,
    throttling, and schema failures are returned as actionable MCP tool errors.
    
logitech_sync_list_placesA

Fetch one controlled page of rooms/desks using the native continuation cursor.

    Use this primitive when exact API pagination or custom projections matter. It never follows
    the cursor automatically. If an explicit projection requests device info, sensors, or
    warranty while ``detail_level=concise``, the result is transparently promoted to detailed
    output and reports that adjustment. A response that is too large fails with guidance
    instead of silently discarding requested fields or inaccessible items.

    Returns ``places`` and metadata including ``next_continuation`` and the effective
    projection. Errors explain how to fix invalid scopes, projections, credentials, or quotas.
    
logitech_sync_search_inventoryA

Search across place and device inventory as one agent-oriented workflow.

    This tool follows bounded pagination and dynamically requests identity, location, contract,
    network, version, and health fields needed for useful matches. Use an exact id/serial for a
    specific entity or partial text for discovery. It does not modify inventory.

    Returns matching place/device objects plus complete/partial pagination metadata. Increase
    ``max_pages`` only when ``next_continuation`` shows the API scan was partial. When
    ``nextResultOffset`` is returned, repeat the same filters with that ``result_offset``.
    
logitech_sync_get_inventory_summaryA

Aggregate rooms, desks, coverage, device types/models/versions, status, and health.

Use this before deeper reports to understand inventory shape without returning every raw device. Pagination is bounded and all counts clearly indicate whether the scan completed.

Returns counters and ranked model/version buckets. It is read-only and uses a projection optimized for identity, coverage, and health aggregation.

logitech_sync_list_device_issuesA

Diagnose offline, unhealthy, stale, or incomplete-peripheral devices.

    Each returned device includes explicit reason codes and its containing room/desk. A stale
    cutoff is only applied to Offline devices when the caller provides
    ``last_disconnection_before`` because Logitech defines ``lastSeen`` as the last
    disconnection event, not a heartbeat. Timestamps remain UTC and retain raw epoch values.

    Returns issue counts, reason counts, bounded issue details, and scan-completeness metadata.
    
logitech_sync_get_occupancy_reportA

Report live room occupancy, known capacity, utilization, and over-capacity state.

    Logitech documents ``seatCount=0`` as unset, so this workflow marks capacity unknown and
    never divides by zero or labels such rooms over capacity. Results are sorted by current
    occupancy and can be filtered with caller-supplied thresholds.

    Returns bounded room rows and aggregate occupancy/capacity metrics. Live values may change.
    
logitech_sync_get_environment_reportA

Aggregate Spot/Rally Board sensor readings with explicit numeric filters.

    Supported measurements include CO2, pressure, temperature, humidity, TVOC, VOC index,
    PM10, PM2.5, and presence. The workflow never invents safety thresholds or labels readings
    dangerous; filtering only occurs when ``metric`` and caller-provided bounds are supplied.

    Returns device readings, UTC sample timestamps, per-metric min/max/average, and scan status.
    
logitech_sync_get_coverage_reportA

Audit room/desk contracts, licenses, and device warranties at a given date.

    Rows are classified as expired, expiring, active, or unknown expiration. Supply ``as_of``
    for reproducible historical/evaluation queries; otherwise today's UTC date is used. Raw
    epoch timestamps and ISO forms are both retained.

    Returns status counts and chronologically sorted coverage rows. No renewal action occurs.
    
logitech_sync_list_network_inventoryA

Inventory reported device IPs, MACs, hostnames, and network interfaces.

Search by network identifier, place, or device, and optionally filter by interface mode. Missing network fields remain absent rather than being invented because reporting varies by device model and firmware. This tool does not scan the network or change configuration.

Returns bounded entries, interface-mode counts, and scan-completeness metadata.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/bouchecousue/logitech-sync-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server