# Connected apps

Source: https://frameleaf.app/docs/admin/connected-apps/

Connected apps are apps that use a Frameleaf library on someone's behalf: AI assistants such as [Claude and ChatGPT](https://frameleaf.app/docs/using/connect-ai-agents/), assistants on your own computer, [Home Assistant](https://frameleaf.app/docs/using/home-assistant/), [Lightroom Classic](https://frameleaf.app/docs/using/lightroom/), and automation and note-taking tools: [Zapier](https://frameleaf.app/docs/using/zapier/), [Make](https://frameleaf.app/docs/using/make/), [n8n](https://frameleaf.app/docs/using/n8n/), [Obsidian](https://frameleaf.app/docs/using/obsidian/) and [Raycast](https://frameleaf.app/docs/using/raycast/). Each person connects their own apps. An app asks first, gets only the permissions that person allows, and loses access the moment it's removed.

Connected apps sign in with OAuth, so nobody types a password or copies a key into the app. For scripts and the command-line tool, use an [API key](https://frameleaf.app/docs/admin/api-and-cli/) instead.

## How an app connects

1. You add Frameleaf in the app, for example with your [assistant address](https://frameleaf.app/docs/using/connect-ai-agents/#copy-your-assistant-address) or your server's address.
2. The app sends you to Frameleaf's **Allow an app** page in your browser. Sign in if you need to.
3. The page lists what the app will be able to do, and what it won't. A **Verified app** is one Frameleaf checked, such as Claude or ChatGPT. Any other app says **Frameleaf hasn't checked this app**.
4. Choose **Allow** or **Deny**.

The app stays connected until you remove it.

## Permissions

An app asks for one or more of these. If it doesn't name any, it gets **library:read** only.

| Permission         | On the Allow page                             | What the app can do                                                                                  |
| ------------------ | --------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| `library:read`     | See and search your photos, videos and albums | View and search photos and videos, and read albums, the timeline, memories, the map, tags and stacks |
| `library:download` | Download your original files                  | Download original files                                                                              |
| `albums:write`     | Add photos to albums and make new albums      | Create albums and add photos and videos to albums                                                    |
| `tags:write`       | Add tags to your photos, or take them off     | Create tags, and add tags to photos and videos or take them off                                      |
| `people:read`      | See the names of people and pets you've named | Read the people and pets you've named                                                                |
| `photos:upload`    | Upload photos and videos to selected Photos albums | Upload new photos and videos into the Photos albums you chose                                   |
| `boards:upload`    | Save files to selected Boards                 | Save new files into the [Boards](https://frameleaf.app/docs/using/boards/) you chose                                      |
| `events:read`      | Read updates from the albums you allow        | See when photos are ready, added to an album you chose, or come out of a Studio export               |

### Choose albums

Apps such as [Zapier](https://frameleaf.app/docs/using/zapier/), [Make](https://frameleaf.app/docs/using/make/), [n8n](https://frameleaf.app/docs/using/n8n/), [Obsidian](https://frameleaf.app/docs/using/obsidian/), [Raycast](https://frameleaf.app/docs/using/raycast/) and [Lightroom Classic](https://frameleaf.app/docs/using/lightroom/) use Connect, which also asks which albums the app may use:

- **Albums this app can read**: tick each album, or **Read my whole library**. Only the albums you choose are included; albums inside them aren't included automatically.
- **Albums this app can write to**: the albums it may add photos, tags or uploads to.
- **Allow new albums in** Photos or Boards: whether it may make albums of its own there.

You can take albums away later in **Details** for the app. To give it more, connect the app again. An app that runs on the internet, such as Zapier or Make, can reach your own HTTPS address without a Frameleaf plan.

No permission lets an app:

- open your Locked photos and videos, or items hidden by your [Locked rules](https://frameleaf.app/docs/using/private-content/#locked-rules). No app ever can, even while you're unlocked in your browser;
- lock anything. An app can't add photos to a Locked album, which would lock them, or turn on automatic adding for one;
- delete anything or empty your Trash;
- share anything, or see other people's libraries on this server;
- change your password or how you sign in;
- use administrator settings, even if your account is an administrator's.

MCP assistants use the permissions for search, named people, albums and tags. Original downloads are available through the Server API.

## Your connected apps

Open **Settings**, then **Your sign-in & privacy**, then **Connected apps**. The **Connected apps** row shows how many apps can use your library, and turns amber when one hasn't been used for 90 days.

**Apps you've allowed** lists each app with:

- what it can do, in a few words, such as **sees your photos** and **adds to albums**;
- when it was last used, and whether that was **On your home network** or **Through remote access**;
- when you allowed it.

**Details** shows the full list of what the app can and can't do, and whether Frameleaf verified it. These are only your apps: everyone on the server connects their own.

### Remove an app

Choose **Remove** next to the app, then **Remove access**. The app stops being able to use your library straight away. What it already showed you, such as answers in a chat, stays in the app. To use it again, connect it again, and it asks you first.

Frameleaf also removes an app's access if it sees one of the app's sign-ins used twice, which can mean someone copied it.

### Account activity

Your [account activity](https://frameleaf.app/docs/using/account-activity/) records when you allow or deny an app, when an app uses your library (at most once an hour per app), each tool an AI assistant calls, and when access ends. It holds the app's name and permissions, never a password or sign-in code. Choose **Apps** on that page to see only these.

Administrators see the same rows for everyone in the [Activity log](https://frameleaf.app/docs/admin/users/#activity-log), including an app that Frameleaf **Cut off** for safety.

## Request limits

Each connected app can make 600 requests a minute, and 3,000 a minute for thumbnails and previews. The limit belongs to the app, wherever it calls from, at home or through remote access. Your own browser, your phone apps and your API keys aren't counted.

An app that goes over gets a "too many requests" answer that says how long to wait, and can carry on after that. Signing in again doesn't reset the count, and requests that were refused still count.

## Away from home

Apps that run on the internet, such as Claude and ChatGPT, reach your server through [remote access](https://frameleaf.app/docs/cloud/remote-access/), which comes with a Frameleaf plan. Without a plan, your server is on your home network only, and only apps on that network can connect. Through remote access, an app works only for accounts linked to their own Frameleaf account, the same rule as for API keys.

## For administrators

In **Settings**, then **Who can sign in**, then **Sign-in methods**, the **Registered apps** section lists every app that can ask people on this server for access.

- **Let new apps register themselves** (on). AI assistants such as Claude and ChatGPT add themselves when someone connects them. Each person still has to choose **Allow** before an app can see anything. Turn it off to allow only apps that are already registered. An app that tries to connect then says the server doesn't let new apps connect themselves.
- **AI agents (MCP)** (on). Lets people connect AI agents to their library through MCP. Turning it off also stops existing agents from using the library.

**Set up an app** registers an app that doesn't register itself, such as [Zapier](https://frameleaf.app/docs/using/zapier/), [Make](https://frameleaf.app/docs/using/make/) or [n8n](https://frameleaf.app/docs/using/n8n/). Under **Name**, choose **Make**, **Zapier** or **Other** (and type a name). In **Sends you back to**, paste the exact return address the app shows; it has to be HTTPS, or a loopback address for an app on the same computer. Choose **Create** and give people the **App ID**, which isn't a password.

Each registered app shows whether Frameleaf checked it, whether it registered itself, and how many people allow it. **Remove** ends everyone's access to that app straight away. It can register again while new apps may register themselves.

Apps that registered themselves but that nobody allowed are tidied away after a day once the server has 500 of them.
