Pica ToolKit

Pica's ToolKit provides enterprise-grade integration capabilities for AI agents built with the Vercel AI SDK. Through Pica's integration layer, agents can seamlessly interact with third-party services and APIs while maintaining enterprise security, compliance, and reliability standards.

Installation

npm install @picahq/toolkit

Setup

Create a new Pica account
Create a Connection via the Pica Dashboard
Create a Pica API key
Set the API key as an environment variable: PICA_SECRET_KEY=<your-api-key>

Usage

The Pica ToolKit seamlessly integrates with Vercel AI SDK, enabling powerful AI capabilities in your applications. Below is a simple example showing how to implement it in a Vercel Agent with read-only permissions on a Gmail connection.

import { Pica } from '@picahq/toolkit';
import { openai } from '@ai-sdk/openai';
import {
  streamText,
  UIMessage,
  convertToModelMessages,
  stepCountIs
} from 'ai';

export async function POST(req: Request) {
  const { messages }: { messages: UIMessage[] } = await req.json();

  const pica = new Pica(process.env.PICA_SECRET_KEY!, {
    connectors: ["test::gmail::default::6faf1d3707f846ef89295c836df71c94"],
    permissions: "read"
  });

  const systemPrompt = pica.systemPrompt;

  const result = streamText({
    model: openai("gpt-4.1"),
    messages: convertToModelMessages(messages),
    tools: {
      ...pica.tools() // Load the Pica ToolKit
    },
    system: systemPrompt,
    stopWhen: stepCountIs(25)
  });

  return result.toUIMessageStreamResponse();
}

⭐️ Experience the Pica ToolKit's capabilities firsthand through our interactive demo chat application here

What can Pica do?

After installing the SDK and integrating your platforms through the Pica dashboard, you can effortlessly create sophisticated AI agents to orchestrate and automate your business workflows.

Here are some powerful examples use cases:

Communication & Productivity

Compose and send Gmail emails containing meeting summaries to team members
Schedule Google Calendar events with specified date/time parameters
Post messages with campaign analytics to designated Slack channels
Search and retrieve Q3 planning materials from Google Drive

Data Access & Analysis

Execute PostgreSQL queries to identify top customer segments
Generate new Google Sheets workbooks populated with sales metrics
Retrieve closing opportunity data from Salesforce CRM
Maintain project tracking databases in Notion workspaces

Business Operations

Create customer support cases in Zendesk from feedback data
Process customer refund transactions via Stripe
Convert website inquiries into HubSpot lead entries
Generate client invoices through QuickBooks integration

AI & Content

Create DALL-E images matching product requirements
Convert meeting audio to text using ElevenLabs
Conduct market research via Tavily/SerpApi integrations
Perform sentiment analysis on support interactions

License

This project is licensed under the GPL-3.0 license. See the LICENSE file for details.