KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

teams-chat-backup

★ 57 Open GitHub ↗

Microsoft Teams chat backup

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Microsoft Teams Chat Backup

This project retrieves a full chat history (messages and uploaded files) and renders it as an HTML.

# Important notice

The maintainer does no longer have the need for this tool, nor can't find the time to keep it alive. Therefore this repository is set to read-only. If anyone is willing to maintain this utility, feel free to fork this repository.

## Requirements

Node.js 10 (or higher). Tested on macOS and Windows, but will most likely run on Linux too.

# Setup

Like any other JS project, clone this repo and run the following command to install dependencies:

```sh
npm install
```

# Run

To backup a chat, run:

```sh
npm run start
```

This will ask several questions:

**Chat ID** - this is the identifier of the conversation. To find it:

1. Go to [https://teams.microsoft.com](https://teams.microsoft.com)
2. Go to the chat you'd like to export.
3. Copy chat ID from URL. It looks like `19:<uuid of one user>-<uuid of other user>@unq.gbl.spaces`

**Auth token (JWT)** - this is needed for calling Microsoft Graph APIs.

1. Go to [https://developer.microsoft.com/en-us/graph/graph-explorer](https://developer.microsoft.com/en-us/graph/graph-explorer). At the left side, under Authentication, click "Sign In with Microsoft"
2. After having logged in, on the left side (where you clicked for login), click "modify permissions". Enable `Chat.Read` and re-login (like it states).
3. The URL contains the token (`#access_token=<long token goes here>`). Copy this value. Or make any random call in the sandbox and copy the Authorization request header either from the JS console (without `Bearer ` in front of it) or from the "Access token" tab of the Graph Explorer page.

**Target directory name** - is the name to use for the export (will be created in the `out` directory in this project).

# Output

An exported chat contains:

* `messages-#####.json`: these are the pages of messages. Page 0000 is the most recent one (pages and messages within are in reverse order).
* `image-#####`: these are images uploaded in the chat
* `index.html`: is the full history rendered into a simple HTML template, referring to the downloaded images. This is the file you want for viewing.

# To Do

* Make an easier way of obtaining a token.
* Add support for bot messages (for example a form).

teams-chat-backup

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README