🚀 Ship Microsoft 365 Copilot connectors fast — from a single TypeSpec file to a runnable, production-ready project.

cocogen is a TypeSpec-driven generator (run via npx) for scaffolding Microsoft Graph External Connections (Microsoft 365 Copilot connectors) projects.

You bring: a .tsp schema.
You get: a runnable TypeScript or C# connector project with clear defaults, great structure, and a friendly CLI. ✨

Disclaimer This is a personal open‑source project and is not affiliated with, endorsed by, or supported by Microsoft. Microsoft, Microsoft 365, Copilot, and Graph are trademarks of Microsoft Corporation

• Schema-first workflow — define your external item once in TypeSpec.
• Runnables out of the box — provision connections, register schemas, and ingest data.
• People connectors ready — profile source registration and person entity mappings.
• Preview-aware — beta features like contentCategory are supported with a flag.
• Swappable datasource — CSV included, plug in your own source easily.
• Safe updates — regenerate only schema-derived code via cocogen update.

• ✅ Create or update an external connection
• ✅ Patch schema changes
• ✅ Ingest items from CSV (or your own datasource)
• ✅ Retry throttled requests with backoff + logging
• ✅ Customize transforms without losing changes on update

End-user guide:

• docs/end-user.md

Tutorials:

• Content connector tutorial
• People connector tutorial

Agent schema guidance:

• docs/schema-assistant.md

cocogen expects a single “item model” decorated with @coco.item() and a single ID property decorated with @coco.id.

Example (product):

import "@wictorwilen/cocogen";
using coco;

@coco.connection({
	name: "Product catalog",
	connectionId: "productcatalog",
	connectionDescription: "External product catalog",
	contentCategory: "uncategorized"
})
@coco.item()
model Product {
	@coco.id
	@coco.schemaDescription("Unique product identifier.")
	@coco.search({ queryable: true, retrievable: true })
	productId: string;

	@coco.label("title")
	@coco.schemaDescription("Display name shown in search results.")
	@coco.search({ searchable: true, retrievable: true })
	name: string;

	@coco.label("url")
	@coco.schemaDescription("Canonical product page URL.")
	@coco.search({ retrievable: true })
	url: string;

	@coco.content({ type: "text" })
	description: string;
}

Start here:

• docs/typespec.md
• docs/azure-functions.md

Examples:

• examples/content-connector.tsp
• examples/people-connector.tsp

• Node.js 22+ (the generator targets Node 22 LTS)
• A TypeSpec schema file (.tsp)
• Generated projects support managed identity (preferred) or client secret auth.

No install needed:

npx @wictorwilen/cocogen@latest --help

Global install (system-wide command):

npm i -g @wictorwilen/cocogen
cocogen --help

Notes:

• --use-preview-features is required for Graph beta schemas (for example people connectors).

npx @wictorwilen/cocogen@latest init --prompt

init also creates package.json and tspconfig.yaml in the same folder (if missing) so TypeSpec can resolve @wictorwilen/cocogen.

npx @wictorwilen/cocogen@latest validate --tsp ./schema.tsp

Use --use-preview-features for Graph beta schemas (for example people connectors).

npx @wictorwilen/cocogen@latest generate --tsp ./schema.tsp --out ./my-connector

Notes:

• cocogen will fail fast if the schema is invalid.
• Beta features require --use-preview-features.
• Use --data-format custom to emit a stub datasource for custom backends.

After init, the project contains a cocogen.json that records which .tsp file to use.

When you change the schema, regenerate only the TypeSpec-derived files:

npx @wictorwilen/cocogen@latest update --out ./my-connector

Override the TypeSpec entrypoint (also updates cocogen.json):

npx @wictorwilen/cocogen@latest update --out ./my-connector --tsp ../schema.tsp

cocogen intentionally separates:

• src/<ConnectionName>/** — generated from TypeSpec (safe to overwrite on cocogen update)
• src/** (non-generated) — runtime code you can edit safely (should not change on update)

• Colors are enabled by default in TTYs.
• Set NO_COLOR=1 to disable colors/spinners.
• In CI/non-TTY, spinners are automatically disabled.

MIT. See LICENSE.

Microsoft, Microsoft Graph, Microsoft 365, and Microsoft 365 Copilot are trademarks of Microsoft Corporation.