Skip to content
Ren Docs
Book a demo

Apps

An app connects Ren to a service like Gmail, Linear, HubSpot, or Shopify. For example, Gmail lets Ren read, summarize, and draft email.

In the API and CLI, an app is a blueprint with kind: app.

How apps work

An app usually provides tools through an MCP server and can include skills that explain how to use those tools. Connect the account or key the app needs. An app’s skills are listed with the app, not under Marketplace → Skills.

Add an app to a project to make it available in every chat. Projects in the same space reuse the connected account. See Connect an account for credential storage.

Apps provide tools, while channels receive requests and deliver replies. For example, the Linear app reads and updates issues, and the Linear channel receives issues assigned to Ren.

If a tool has no app but does have an MCP server, add it as a custom MCP.

Find an app

Open Marketplace → Apps to browse or search by name. Select an app to see the MCPs and skills it adds, the publisher, and links to its documentation.

You can also browse apps without signing in on the public Blueprints catalog.

Add an app to a project

  1. Open Marketplace → Apps and select the app.
  2. Select Add, then pick a project.
  3. If the app needs an account, sign in or enter its key, then select Add to and the project name.

The app’s MCPs and skills are attached to the project and ready in its next chat.

Connect an account

When Ren needs an app that isn’t connected, it shows a connect card in the chat. Connecting from the card also adds the app to the project if it isn’t there yet.

  1. Select Connect on the card in the chat.
  2. Sign in to the account you want Ren to use, or enter the key the app asks for.
  3. Return to Ren. The card shows Connected, and Ren continues.

Some apps, such as Figma, Meta Ads, and Shopify, end sign-in on a page that won’t load. That’s expected. Copy that page’s full address from the browser, paste it into Paste the address from the sign-in tab on the card, and select Finish.

If another space you belong to has a connection, select Reuse to copy it into this space, or select Add new to connect a different account.

The connection is saved in the project’s space. In your personal space, it’s saved in your personal credentials. If your organization already has a connection for the app, Ren uses it, and the connection dialog shows Connected using organization credentials. See Which credential Ren uses.

Use an app in a chat

Type @ in the composer and pick the app. The mention tells Ren which app to use for that request:

@Gmail summarize my unread email from today.

Mentions are optional. Mention an app to choose between services that can handle the request. If the project doesn’t have the app, Ren shows a connect card to add it.

Remove an app

  1. Open Marketplace → Apps and select the app.
  2. Select Add to open the project list, then select a project with a check mark to remove the app from it.

Removing an app detaches its MCPs and skills from the project. Ren also deletes the app’s credentials from the space if no other project in that space still needs them, but credentials at the organization level will stay.

FAQ

Can a space have two accounts for the same app?

No. Each space holds one connection per app, and connecting again replaces it. To use two accounts, connect one in each space, or one at the organization level and one in the space.

Which account does Ren use when the app is connected in several places?

In shared spaces, Ren uses the space’s connection before the organization’s. In your personal space, your personal connection comes first. See Which credential Ren uses for the full lookup order.