Home/Tools/@tpmjs/official-agnt

notionSearch

@tpmjs/official-agnt

Search pages and databases in Notion.

Official
agent
v0.1.4
MIT

Interactive Playground

Test @tpmjs/official-agnt (notionSearch) with AI-powered execution

0/2000 characters

Installation & Usage

Install this tool and use it with the AI SDK

1. Install the package

npm install @tpmjs/official-agnt
pnpm add @tpmjs/official-agnt
yarn add @tpmjs/official-agnt
bun add @tpmjs/official-agnt
deno add npm:@tpmjs/official-agnt

2. Import the tool

import { notionSearch } from '@tpmjs/official-agnt';

3. Use with AI SDK

import { generateText } from 'ai';
import { openai } from '@ai-sdk/openai';
import { notionSearch } from '@tpmjs/official-agnt';

const result = await generateText({
  model: openai('gpt-4o'),
  tools: { notionSearch },
  prompt: 'Your prompt here...',
});

console.log(result.text);

Signature

(query: string, filter?: string, pageSize?: number) => Promise<unknown>

Tags

agent
agnt
ai
databases
notion
official
pages
search
tpmjs
workflow

Parameters

Available configuration options

Auto-extracted
query
Required
Type: string

The search query to find pages or databases.

filter
Optional
Type: string

Filter results by object type: "page" or "database". Omit to search both.

pageSize
Optional
Type: number

Maximum number of results to return (default: 10).

Schema extracted: 3/1/2026, 4:26:39 AM

README

@tpmjs/official-agnt

74 production-ready AI SDK v6 tools for the agnt.gg platform and its integrations.

Manage agents, workflows, and goals on the agnt platform. Connect to Google, GitHub, Stripe, Notion, Twitter/X, YouTube, Dropbox, and more -- all through a single package with a unified interface.

npm license

Installation

npm install @tpmjs/official-agnt
# or
pnpm add @tpmjs/official-agnt

Quick Start

Every tool follows the AI SDK v6 tool() pattern. Import what you need and call .execute():

import { googleSearch, chatWithAgent, generateWorkflow } from '@tpmjs/official-agnt';

// Search the web
const results = await googleSearch.execute({ query: 'latest AI research' });

// Chat with an agnt agent
const response = await chatWithAgent.execute({
  agentId: 'agent-123',
  message: 'Summarize the search results',
});

// Generate a workflow from a description
const workflow = await generateWorkflow.execute({
  description: 'Scrape a website, extract key data, and save to Google Sheets',
});

Use with the AI SDK's generateText / streamText:

import { generateText } from 'ai';
import { openai } from '@ai-sdk/openai';
import { googleSearch, createIssue, sendGmail } from '@tpmjs/official-agnt';

const { text } = await generateText({
  model: openai('gpt-4o'),
  tools: { googleSearch, createIssue, sendGmail },
  prompt: 'Research the latest Node.js release and create a GitHub issue summarizing the changes.',
});

Platform Tools

Manage agents, workflows, goals, and more on the agnt platform.

Requires: AGNT_API_URL, AGNT_API_KEY

Agents

ToolDescription
listAgentsList all agents on the platform
getAgentGet detailed info about a specific agent
createAgentCreate a new agent with model, system prompt, and tools
updateAgentUpdate an existing agent's configuration
deleteAgentDelete an agent
chatWithAgentSend a message to an agent and get a response

Workflows

ToolDescription
listWorkflowsList all workflows
getWorkflowGet workflow details including nodes and edges
createWorkflowCreate a new workflow with nodes and edges
deleteWorkflowDelete a workflow
startWorkflowStart executing a workflow
stopWorkflowStop a running workflow
getWorkflowStatusCheck the current status of a workflow
generateWorkflowGenerate a workflow from a natural language description

Goals

ToolDescription
listGoalsList all goals on the platform
createGoalCreate a new goal with steps and optional agent assignment
executeGoalExecute a goal
getGoalStatusCheck goal progress and status
deleteGoalDelete a goal

Orchestrator & Executions

ToolDescription
generateAgentGenerate an agent from a natural language description
orchestratorChatChat with the multi-agent orchestrator
listExecutionsList past executions
getExecutionGet details of a specific execution
listCustomToolsList custom tools on the platform
createCustomToolCreate a new custom tool with schema and code
deleteCustomToolDelete a custom tool

Integration Tools

Google Search

Env: GOOGLE_SEARCH_API_KEY, GOOGLE_SEARCH_ENGINE_ID

ToolDescription
googleSearchSearch the web via Google Custom Search API
const results = await googleSearch.execute({
  query: 'best practices for AI agents',
  numResults: 5,
});

HTTP Request

Env: None required

ToolDescription
httpRequestMake HTTP requests with configurable method, headers, auth
const data = await httpRequest.execute({
  url: 'https://api.example.com/data',
  method: 'GET',
  authType: 'bearer',
  authValue: 'my-token',
});

OpenAI Text-to-Speech

Env: OPENAI_API_KEY

ToolDescription
textToSpeechConvert text to speech audio (returns base64 MP3)

Stripe

Env: STRIPE_SECRET_KEY

ToolDescription
createStripeInvoiceCreate, finalize, and send a Stripe invoice
const invoice = await createStripeInvoice.execute({
  customerEmail: 'client@example.com',
  customerName: 'Acme Corp',
  items: JSON.stringify([
    { description: 'Consulting', amount: 5000, quantity: 1 }
  ]),
});

Unsplash

Env: UNSPLASH_ACCESS_KEY

ToolDescription
searchPhotosSearch for photos by keyword
getRandomPhotoGet a random photo, optionally filtered by query
getPhotoGet details of a specific photo by ID

Firecrawl

Env: FIRECRAWL_API_KEY

ToolDescription
firecrawlScrapeScrape a URL and extract content as markdown or HTML

Zapier

Env: None required

ToolDescription
triggerZapierWebhookSend JSON data to a Zapier webhook URL

GitHub

Env: GITHUB_TOKEN

ToolDescription
createIssueCreate a new issue in a repository
createPullRequestCreate a new pull request
getRepoInfoGet repository information (stars, forks, etc.)
listPullRequestsList pull requests with filtering
getFileContentGet the content of a file from a repo
listCommitsList recent commits
const issue = await createIssue.execute({
  owner: 'my-org',
  repo: 'my-repo',
  title: 'Bug: Login fails on mobile',
  body: 'Steps to reproduce...',
  labels: 'bug,mobile',
});

Google Sheets

Env: GOOGLE_SERVICE_ACCOUNT_KEY

ToolDescription
readSheetRead data from a spreadsheet range
writeSheetWrite data to a spreadsheet range
appendSheetAppend rows to a spreadsheet
clearSheetClear a spreadsheet range

Notion

Env: NOTION_API_KEY

ToolDescription
notionSearchSearch pages and databases
notionQueryDatabaseQuery a database with filters and sorts
notionGetPageGet a page with its content blocks
notionCreatePageCreate a new page in a database or under a parent

Twitter / X

Env (reads): TWITTER_BEARER_TOKEN Env (writes): TWITTER_API_KEY, TWITTER_API_SECRET, TWITTER_ACCESS_TOKEN, TWITTER_ACCESS_SECRET

ToolDescription
postTweetPost a new tweet (supports replies)
searchTweetsSearch recent tweets
getUserProfileGet a user's profile by username
getUserTweetsGet recent tweets from a user

YouTube

Env: YOUTUBE_API_KEY

ToolDescription
searchVideosSearch for videos
getVideoDetailsGet video metadata, stats, and duration
listChannelVideosList videos from a channel
getTranscriptGet the transcript/captions of a video
const transcript = await getTranscript.execute({
  videoId: 'https://youtube.com/watch?v=dQw4w9WgXcQ',
});
console.log(transcript.text);

Gmail

Env: GOOGLE_SERVICE_ACCOUNT_KEY, GMAIL_USER_EMAIL

ToolDescription
searchEmailsSearch emails using Gmail search syntax
readEmailRead the full content of an email
sendGmailSend an email (with optional CC/BCC)

Dropbox

Env: DROPBOX_ACCESS_TOKEN

ToolDescription
listFolderList files and folders in a directory
uploadFileUpload a file
downloadFileDownload a file
deleteFileDelete a file or folder
createFolderCreate a new folder
createSharedLinkCreate a shared link for a file

Google Drive

Env: GOOGLE_SERVICE_ACCOUNT_KEY

ToolDescription
listDriveFilesList files in a folder
uploadDriveFileUpload a file
downloadDriveFileDownload a file
createDriveFolderCreate a folder
shareDriveFileShare a file with another user

Google Slides

Env: GOOGLE_SERVICE_ACCOUNT_KEY

ToolDescription
createPresentationCreate a new presentation
getPresentationGet presentation info and slide list
addSlideAdd a slide with title and body text

Environment Variables

Each integration requires its own credentials. Only set the ones you need:

VariableUsed By
AGNT_API_URLPlatform tools
AGNT_API_KEYPlatform tools
GOOGLE_SEARCH_API_KEYGoogle Search
GOOGLE_SEARCH_ENGINE_IDGoogle Search
OPENAI_API_KEYText-to-Speech
STRIPE_SECRET_KEYStripe
UNSPLASH_ACCESS_KEYUnsplash
FIRECRAWL_API_KEYFirecrawl
GITHUB_TOKENGitHub
GOOGLE_SERVICE_ACCOUNT_KEYSheets, Drive, Slides, Gmail
GMAIL_USER_EMAILGmail
NOTION_API_KEYNotion
TWITTER_BEARER_TOKENTwitter (reads)
TWITTER_API_KEYTwitter (writes)
TWITTER_API_SECRETTwitter (writes)
TWITTER_ACCESS_TOKENTwitter (writes)
TWITTER_ACCESS_SECRETTwitter (writes)
YOUTUBE_API_KEYYouTube
DROPBOX_ACCESS_TOKENDropbox

TypeScript

All input and output types are exported:

import type {
  AgntAgent,
  AgntWorkflow,
  GoogleSearchResult,
  CreateIssueResult,
  TranscriptResult,
} from '@tpmjs/official-agnt';

License

MIT

Statistics

Downloads/month

520

GitHub Stars

0

Quality Score

82%

Bundle Size

NPM Keywords

tpmjs
agnt
agent
workflow
ai

Maintainers

thomasdavis(thomasalwyndavis@gmail.com)

Frameworks

vercel-ai