Docs/Connections

Connections

Connect your agent to Slack, email, calendar, messaging apps, and more — so it can help you everywhere you work.

What Are Connections?

Connections let your AI assistant integrate with the tools you already use. Once connected, your agent can:

  • Read and respond to Slack messages on your behalf
  • Send emails, create calendar events, and manage your schedule
  • Monitor messaging apps like WhatsApp, Telegram, and Discord
  • Pull data from databases, APIs, and cloud services

All connections respect your security settings — you control what your agent can read, write, and send.

Popular Connections

💬

Slack

Most Popular

Let your agent read channels, send messages, summarize threads, and create tasks from @mentions.

• Read DMs and channel messages
• Respond to @mentions automatically
• Create tasks from Slack threads
• Daily digest of missed messages
📧

Gmail

Triage emails, draft responses, create tasks from important messages, and manage your inbox.

• Summarize unread emails
• Draft replies (you approve before sending)
• Auto-label and archive based on rules
• Create tasks from emails with deadlines
📅

Google Calendar

Check your schedule, create events, send meeting invites, and get pre-meeting briefings.

• View today's schedule
• Create calendar events from natural language
• Get 30-minute pre-meeting reminders
• Suggest optimal meeting times
💚

iMessage

Read and send iMessages from your Mac. Your agent can respond to texts on your behalf (with approval).

• Read recent messages
• Send texts (requires approval)
• Notify you of important messages
• macOS-only connection
💬

WhatsApp, Telegram, Discord

Monitor and respond to messages across other platforms. Great for teams and communities.

• Read messages from specific chats
• Respond with approval
• Create tasks from DMs or mentions
• Integration via MCP servers

MCP Servers (Advanced)

Pinchr supports the Model Context Protocol (MCP) — an open standard for connecting AI assistants to external tools and data sources.

🔌
What is MCP?

MCP servers are plugins that extend your agent's capabilities. They provide access to:

Databases: Postgres, MySQL, MongoDB, Redis
APIs: Stripe, Twilio, GitHub, Notion, Airtable
Cloud: AWS, GCP, Vercel, Cloudflare
Dev Tools: Docker, Kubernetes, CI/CD pipelines

Browse available MCP servers from Settings → Connections → MCP Servers, or check the MCP documentation for details.

How to Add Connections

Your agent will help you set up connections when you need them. Just tell it what you want to do:

You:
"Can you check my Slack messages?"
Agent:
I'll need access to your Slack workspace first. Let me walk you through connecting it...

You can also add connections manually from Settings → Connections:

1. Choose a connection

Browse available integrations and select the one you want to add.

2. Authorize access

Most connections use OAuth — you'll be redirected to authorize Pinchr. Your credentials are never stored.

3. Set permissions

Choose what your agent can read and write. You can adjust these later from Security settings.

4. Test the connection

Your agent will confirm the connection works and show you what it can do.

Managing Connections

View and manage all connections from Settings → Connections:

✏️
Edit Permissions

Change what your agent can access — read-only, read/write, or require approval for each action.

🔄
Refresh Credentials

If a connection stops working, re-authorize it from Settings. OAuth tokens expire periodically.

📊
View Activity

See when your agent last accessed each connection and what it did (from Audit Log).

🗑️
Remove Connection

Disconnect anytime. Your agent will lose access immediately, and credentials are deleted.

Example Use Cases

Here's what becomes possible with connections:

📬
Morning Triage

"Summarize my unread Slack DMs and emails. Create high-priority tasks for anything urgent."

🤖
Auto-Respond to Slack

"If someone @mentions me in #engineering, read the thread and respond if it's a simple question. Ask me first for complex ones."

📅
Smart Scheduling

"Find a 30-minute slot next week when both me and Sarah are free. Send her a calendar invite."

🚨
On-Call Monitoring

"If I get a Slack message in #incidents outside work hours, ping me via iMessage immediately."

💰
Weekly Reports

"Every Friday at 4 PM, draft a weekly update email summarizing my completed tasks. Send it to my manager for approval."

Security & Privacy

All connections are secured and respect your permission settings:

OAuth tokens are encrypted and stored locally using macOS Keychain.
Your agent only accesses connections when you ask it to or via automations you've set up.
Every connection action is logged in the audit log for transparency.
You can require approval for every action (e.g., sending emails, posting messages).

Need help connecting something?

Ask your agent or reach out to our community — we're happy to help.