> For the complete documentation index, see [llms.txt](https://docs.perisclaw.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.perisclaw.com/skills-and-integrations/connecting-apps.md).

# Connecting apps

Perisclaw can do more than WhatsApp and Google. Through **connectors**, you can plug in your other tools — a project tracker like Linear, a CRM, a food-ordering service, and more — and then use them by just asking in chat. Instead of hopping between apps, your assistant becomes the hub.

{% hint style="info" %}
Connectors use **MCP** (Model Context Protocol), an open standard for letting assistants talk to other apps. You don't need to know the details — you just connect an app once and start using it.
{% endhint %}

## Two ways to connect

* **From the catalog** — browse the ready-to-connect apps in your dashboard and add one with a couple of taps.
* **Bring your own** — connect any app that offers an MCP endpoint by adding its address and signing in. Great for your own internal tools.

## How connecting works

Connecting always happens on the **dashboard**, never in chat — that keeps your passwords and keys out of your WhatsApp history.

{% stepper %}
{% step %}

### Ask in WhatsApp

Tell your assistant what you want to connect — *"connect my Linear."* It replies with a secure link to the dashboard.
{% endstep %}

{% step %}

### Authorize on the dashboard

Tap the link. On the dashboard you either sign in to the app (a normal "allow access" screen) or paste the app's address and access token. Perisclaw stores it securely.
{% endstep %}

{% step %}

### Start using it in chat

Your assistant confirms the connection and lists what it can now do — for example, *"✅ Linear connected. Try: 'log Sam's bug as a Linear issue.'"* From then on, just ask.
{% endstep %}
{% endstepper %}

## What you can do once connected

Anything the app exposes becomes available in plain language:

* *"Order dinner from my usual place."*
* *"Create a Linear issue for this bug and assign it to me."*
* *"Find the Notion doc about the Q3 budget."*

You can also weave connected apps into longer [jobs](/what-perisclaw-can-do/autonomous-jobs.md) — *"open a ticket in our CRM, wait for it to be assigned, then tell the team."*

## Managing your connections

* **See what's connected** — ask *"what apps do I have connected?"* or check the **Apps** page in the dashboard.
* **Disconnect** — say *"disconnect Linear"* (it'll confirm first) or remove it from the dashboard.

## Safety

{% hint style="success" %}
**Your credentials never travel through WhatsApp.** They're entered on the dashboard and stored encrypted. When a connected app is about to take a real action on your behalf (not just read something), your assistant confirms with you first.
{% endhint %}

Perisclaw also screens the addresses you connect to and limits how many apps and tools can be added, to keep your private server safe. For how access and approvals work in general, see [Permissions & access](/security-and-control/permissions-and-access.md).

***

Want to go the other way — use your WhatsApp *from* Claude or Cursor? See [Perisclaw as an MCP server](/use-with-claude-and-other-ai/mcp-server.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.perisclaw.com/skills-and-integrations/connecting-apps.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.