Teams

Lightweight, dependency-free Microsoft Graph Teams and chats fake for local tests with @microsoft/microsoft-graph-client.

Defaults

Quick Start

import { TeamsServer } from "./services/teams/src/server.js";
import { Client } from "@microsoft/microsoft-graph-client";

const server = new TeamsServer(4621);
await server.start();

const client = Client.init({
  baseUrl: "http://127.0.0.1:4621/v1.0",
  authProvider: (done) => done(null, "local-token"),
});

const team = await client.api("/teams").post({
  displayName: "Local Team",
  description: "No Microsoft tenant required",
});

const channel = await client.api(`/teams/${team.id}/channels`).post({
  displayName: "agents",
});

await client.api(`/teams/${team.id}/channels/${channel.id}/messages`).post({
  body: { contentType: "text", content: "Hello from parlel" },
});

const messages = await client.api(`/teams/${team.id}/channels/${channel.id}/messages`).get();
await server.stop();

Implemented Operations

Collection responses support a lightweight OData subset: $top, $skip, $count, $filter, $search, $orderby, and $select. Single resource reads support $select where practical. Both /v1.0 and /beta prefixes route to the same implementation.

Emulator

Users

Teams

Team Members

Channels

Channel Members

Channel Messages and Replies

Tabs

Installed Apps

Chats and Chat Members

Chat Messages

Subscriptions and Batch

Surface coverage

This emulator faithfully replicates the API surface most application code and agents exercise. Anything below the supported lines is either an intentional design choice for a fast, zero-cost local emulator (✓ By design) or a candidate for a future release (⟳ Roadmap) — never a silent inaccuracy.

Legend: ✅ fully supported · ◐ accepted (stored, not strictly enforced) · ✓ by design · ⟳ on the roadmap.

Error Shapes

Errors follow the Microsoft Graph JSON shape:

{
  "error": {
    "code": "ErrorItemNotFound",
    "message": "Team not found",
    "innerError": {
      "date": "2026-06-11T00:00:00.000Z",
      "request-id": "req_...",
      "client-request-id": "optional-client-id"
    }
  }
}

Common returned codes:

Configuration — test.env

Copy these into your test.env (used by the bridge sidecar flow). Tokens are Parlel's seeded test credentials — any non-empty value is accepted by the emulator, so you rarely need to change them. Swap in real credentials only when pointing at the live service in prod.env.

TEAMS_EMULATOR_HOST=http://parlel-bridge:4621
MICROSOFT_GRAPH_BASE_URL=http://parlel-bridge:4621/v1.0
AZURE_TENANT_ID=parlel
AZURE_CLIENT_ID=parlel
AZURE_CLIENT_SECRET=parlel