ibabs-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ibabs-mcp list my upcoming council meetings"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-mcpRequires 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 |
| yes | Tenant/site name, e.g. |
| yes | Login e-mail address. |
| yes* | Login password. |
| yes* | A pre-existing |
| no | Where the session is cached. Defaults to the OS cache dir. |
| no | Where attachments are written. Defaults to |
| no | Defaults to |
| no | Defaults to |
| no | Defaults to |
| no | OAuth client id. Defaults to the public iBabs portal client. |
| no | OAuth redirect. Defaults to |
* 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 bydocumentId, 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.
Bump the version in
package.jsonand commit.Tag and push:
git tag v0.1.0 && git push origin v0.1.0.The
PublishGitHub Action builds, tests, and runsnpm publishwith provenance.
The npm trusted publisher must be configured for repository
anned20/ibabs-mcp, workflow publish.yml.
License
Available Tools
3 toolsget_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
Scored across 3 tools
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.
All three tools follow a consistent snake_case verb_noun pattern: list_meetings, get_meeting, get_attachment. The convention is predictable and readable.
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.
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
Related MCP Connectors
Extract PDFs into structured tables, query records, and configure document inbox workflows.
Search, read and cite documents. Add, replace and delete files with write access. OAuth required.
Search, read, and automate TextMine documents, records, workflows, integrations, and agent tasks.
Read persons, organization units, absences, job postings and applications in HR WORKS.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables listing and downloading scanned letters from the Swiss ePost digital letterbox through browser automation, requiring manual SwissID login for session establishment.2330 npm2MIT
- AlicenseNot gradedqualityDmaintenanceSafely 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
- AlicenseAqualityBmaintenanceEnables agents to access TU Delft Brightspace courses, materials, assignments, grades, and more through authenticated local sessions.658MIT
- AlicenseNot gradedqualityCmaintenanceEnables interacting with iServ school portals to read parent letters and attachments, mark letters as read, access timetables, and submit guardian sick notes.MIT