Ibabs

GitHub Actions

Local MCP server for iBabs: list meetings, agenda items and attachments.

Add to Cursor Add to VS Code Run on PlugMCP

1{2  "mcpServers": {3    "ibabs-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ]9    }10  }11}

.cursor/mcp.jsonMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add ibabs-mcp -- npx -y ibabs-mcp@0.2.3

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "ibabs-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.2.3
Last checked: 2026-10-28

Stars: —
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Ibabs?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Ibabs need an API key?

No required environment variable is listed on this record.

What transport does Ibabs use?

Ibabs runs locally over stdio.

When was Ibabs last checked?

Last checked 2026-10-28. Local MCP server for iBabs: list meetings, agenda items and attachments.

From the publisher

Documentation

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.

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:

[email protected]
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": "[email protected]",
        "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.json and commit.
Tag and push: git tag v0.1.0 && git push origin v0.1.0.
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

Ibabs

GitHub Actions

Local MCP server for iBabs: list meetings, agenda items and attachments.

Devops Developer Tools

Add to Cursor Add to VS Code Run on PlugMCP

GitHub npm Website

Add to Cursor Add to VS Code Run on PlugMCP

1{2  "mcpServers": {3    "ibabs-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ]9    }10  }11}

.cursor/mcp.jsonMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add ibabs-mcp -- npx -y ibabs-mcp@0.2.3

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "ibabs-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.2.3
Last checked: 2026-10-28

Stars: —
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Ibabs?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Ibabs need an API key?

No required environment variable is listed on this record.

What transport does Ibabs use?

Ibabs runs locally over stdio.

When was Ibabs last checked?

Last checked 2026-10-28. Local MCP server for iBabs: list meetings, agenda items and attachments.

From the publisher

Documentation

ibabs-mcp

Install

Published on npm as ibabs-mcp:

npx -y ibabs-mcp

Requires Node.js 20 or newer.

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:

[email protected]
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": "[email protected]",
        "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.json and commit.
Tag and push: git tag v0.1.0 && git push origin v0.1.0.
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