Skip to main content
Glama

ibabs-mcp

A local Model Context Protocol (MCP) server for iBabs. It logs into an iBabs site with your credentials, caches the portal session, and exposes tools to list meetings, read agenda items, and download attachments.

Install

Published on npm as ibabs-mcp:

npx -y ibabs-mcp

Requires Node.js 20 or newer.

Related MCP server: tender-documents-mcp

Configuration

All configuration comes from environment variables. Set them in the MCP client config (not in a file the server reads), or export them in your shell.

Variable

Required

Meaning

IBABS_SITE

yes

Tenant/site name, e.g. example-site.

IBABS_EMAIL

yes

Login e-mail address.

IBABS_PASSWORD

yes*

Login password.

IBABS_SESSION_COOKIE

yes*

A pre-existing __Host-ibabsportal cookie value, instead of password.

IBABS_CACHE_DIR

no

Where the session is cached. Defaults to the OS cache dir.

IBABS_DOWNLOAD_DIR

no

Where attachments are written. Defaults to <cache>/downloads.

IBABS_PORTAL_URL

no

Defaults to https://portal.ibabs.eu.

IBABS_LOGIN_URL

no

Defaults to https://signon.ibabs.eu.

IBABS_AUTHORIZE_URL

no

Defaults to https://signon.ibabs.eu/OAuth/Authorize.

IBABS_CLIENT_ID

no

OAuth client id. Defaults to the public iBabs portal client.

IBABS_REDIRECT_URI

no

OAuth redirect. Defaults to https://portal.ibabs.eu/signin-iBabs.

* Provide either IBABS_PASSWORD or IBABS_SESSION_COOKIE.

See .env.example for a template.

Use with Hermes Agent

Hermes reads mcp_servers from ~/.hermes/config.yaml and passes only the env you list explicitly. Keep the secret in ~/.hermes/.env and reference it:

mcp_servers:
  ibabs:
    command: "npx"
    args: ["-y", "ibabs-mcp"]
    env:
      IBABS_SITE: "example-site"
      IBABS_EMAIL: "${IBABS_EMAIL}"
      IBABS_PASSWORD: "${IBABS_PASSWORD}"

Then ~/.hermes/.env:

IBABS_EMAIL=you@example.com
IBABS_PASSWORD=...

Restart Hermes (or run /reload-mcp). Tools appear as mcp_ibabs_*.

Tools

  • list_meetings — list meetings in a date range (defaults to the next 30 days), optionally restricted to council/committee meetings.

  • get_meeting — one meeting with its agenda items and attachments.

  • get_attachment — download an attachment by documentId, returning a local path and, for PDFs/plain text, the extracted text.

Other MCP clients

Any stdio MCP client works — point it at npx -y ibabs-mcp with the env above. For Claude Desktop / Cursor:

{
  "mcpServers": {
    "ibabs": {
      "command": "npx",
      "args": ["-y", "ibabs-mcp"],
      "env": {
        "IBABS_SITE": "example-site",
        "IBABS_EMAIL": "you@example.com",
        "IBABS_PASSWORD": "..."
      }
    }
  }
}

Development

npm install
npm run dev      # run from source with tsx
npm run test     # vitest
npm run build    # compile to dist/

Releasing

Publishing uses npm trusted publishing (OIDC) — no long-lived token.

  1. Bump the version in package.json and commit.

  2. Tag and push: git tag v0.1.0 && git push origin v0.1.0.

  3. The Publish GitHub Action builds, tests, and runs npm publish with provenance.

The npm trusted publisher must be configured for repository anned20/ibabs-mcp, workflow publish.yml.

License

MIT

Available Tools

3 tools
get_attachmentDownload an iBabs attachmentB

Download an attachment by documentId and return its name, mime type and local path. PDFs and text files are also returned as extracted text.

Inputs: documentId (required), extractText.

get_meetingGet an iBabs meetingA

Get one meeting by id, including its agenda items with their number, title, confidentiality flag and attachments with name and size. Also includes meeting-level attachments that are not tied to an agenda item.

Inputs: id (required).

list_meetingsList iBabs meetingsA

List your iBabs meetings in a date range, in chronological order. Defaults to the next 30 days. Use type 'council' to only get council/committee meetings.

Inputs: to, from, type.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 3 tools

    Disambiguation5/5

    list_meetings lists meetings, get_meeting retrieves one meeting's full details, and get_attachment downloads a specific attachment. Each tool targets a distinct resource and action with no overlap.

    Naming Consistency5/5

    All three tools follow a consistent snake_case verb_noun pattern: list_meetings, get_meeting, get_attachment. The convention is predictable and readable.

    Tool Count4/5

    Three tools is minimal but well-suited for a read-only API focused on meetings and attachments. Each tool earns its place, though the surface is slightly thin for the broader domain.

    Completeness4/5

    The set covers listing meetings, retrieving a meeting with agenda items and attachments, and downloading attachments. Minor gaps include no search or filtering beyond date and type, but core read-only workflows are covered.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables listing and downloading scanned letters from the Swiss ePost digital letterbox through browser automation, requiring manual SwissID login for session establishment.
      23
      30 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Safely downloads and extracts public tender documents from PDFs, Office files, and ZIP archives into text with structured signals, while also supporting document comparison and base64 extraction.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables interacting with iServ school portals to read parent letters and attachments, mark letters as read, access timetables, and submit guardian sick notes.
      MIT