AtlatestRepositorybureau

bureau / treeREADME.md

Read it rendered

1# Bureau
2
3An MCP server that gives AI assistants access to your Fastmail email and
4calendar. Built with [Sigil](https://codeberg.org/sigil/sigil).
5
6## Installation
7
8```bash
9sigil app install codeberg:sigil/bureau \
11 --env BUREAU_FASTMAIL_API_TOKEN=fmu1-... \
12 --env BUREAU_FASTMAIL_APP_PASSWORD=fmu1-...
13```
15This builds Bureau from source, installs it, and registers it as an MCP server
16in Claude Code automatically.
18By default the server is registered globally (in `~/.claude.json`). To install
19it for only the current project instead:
21```bash
22sigil app install codeberg:sigil/bureau --scope project \
24 --env BUREAU_FASTMAIL_API_TOKEN=fmu1-... \
25 --env BUREAU_FASTMAIL_APP_PASSWORD=fmu1-...
26```
28This writes the server entry to the project's `.mcp.json`.
30### Fastmail Credentials
32Bureau requires two separate Fastmail credentials — an API token for email
33(JMAP) and an app password for calendar (CalDAV):
351. Log in to [Fastmail](https://www.fastmail.com)
362. Go to **Settings** → **Privacy & Security** → **Integrations**
373. Under **API tokens**, create a token with **Mail** access — this is your `BUREAU_FASTMAIL_API_TOKEN`
384. Under **App passwords**, create a password with **Calendars** access — this is your `BUREAU_FASTMAIL_APP_PASSWORD`
40| Variable | Protocol | Auth method | Where to create |
41|----------|----------|-------------|-----------------|
42| `BUREAU_FASTMAIL_USERNAME` | CalDAV | HTTP Basic (username) | Your Fastmail email address |
43| `BUREAU_FASTMAIL_API_TOKEN` | JMAP | Bearer token | Settings → API tokens |
44| `BUREAU_FASTMAIL_APP_PASSWORD` | CalDAV | HTTP Basic (password) | Settings → App passwords |
46## What It Does
48Bureau provides 19 MCP tools that let an AI assistant:
50- **Search and read email** — query by sender, subject, date, text content
51- **Send and reply to email** — with proper threading headers
52- **Manage email** — archive, trash, flag, mark read/unread, move between folders
53- **View calendar events** — query by date range, get full details
54- **Create and modify events** — schedule meetings, update details, delete events
55- **Find free time** — analyze your calendar to find available slots
57## Manual Setup
59If not using `sigil app`, you can build and configure manually:
61```bash
62sigil deps install
63sigil build
64```
66Add to your `.mcp.json`:
68```json
70 "mcpServers": {
71 "bureau": {
72 "type": "stdio",
73 "command": "/path/to/bureau",
74 "args": ["serve"],
75 "env": {
76 "BUREAU_FASTMAIL_USERNAME": "[email protected]",
77 "BUREAU_FASTMAIL_API_TOKEN": "fmu1-...",
78 "BUREAU_FASTMAIL_APP_PASSWORD": "fmu1-..."
79 }
80 }
81 }
83```
85## License
87BSD-3-Clause