Developer Documentation

Connect your tools to Workweaver. CLI commands, MCP integration, SDK libraries, public API endpoints, and browser extension setup.

Workweaver CLI

The Workweaver CLI provides command-line access to WorkMemory, mission control, and tenant management. Install via pip and authenticate with your Workweaver account.

Installation

pip install workweaver

Authentication

ww login

Connect WorkMemory

ww connect workmemory --harness cursor

Available Commands

ww login

Authenticate with your Workweaver account

ww connect

Connect tools and services to WorkMemory

ww memory

Query and manage WorkMemory contents

ww run

Execute workflows and missions

Help

Run ww --help for a complete list of commands and options.

WorkMemory MCP Server

The Model Context Protocol (MCP) server provides WorkMemory integration for AI assistants. Connect Claude Code, Cursor, OpenCode, and other MCP-compatible tools.

Installation

npx @workweaver/workmemory-mcp

Claude Code Configuration

Add to your Claude Code MCP configuration:

{
  "mcpServers": {
    "workmemory": {
      "command": "npx",
      "args": ["@workweaver/workmemory-mcp"],
      "env": {
        "WORKWEAVER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cursor Configuration

Add to your Cursor MCP settings:

{
  "workmemory": {
    "command": "npx",
    "args": ["@workweaver/workmemory-mcp"],
    "env": {
      "WORKWEAVER_API_KEY": "your_api_key_here"
    }
  }
}

Available Tools

workmemory_search

Search WorkMemory by semantic similarity

workmemory_add

Add facts and episodes to WorkMemory

workmemory_recall

Recall recent memories and patterns

workmemory_configure

Configure memory scopes and retention

Documentation

See the WorkMemory MCP README for detailed setup instructions.

Workweaver SDKs

Official SDK libraries for TypeScript, Python, LangChain, OpenAI, and Vercel. Integrate WorkMemory and Workweaver execution into your applications.

TypeScript SDK

npm install @workweaver/workmemory-sdk-ts

Python SDK

pip install workmemory-sdk-py

LangChain Integration

pip install workmemory-langchain

OpenAI Integration

npm install @workweaver/workmemory-openai

Vercel AI SDK Integration

npm install @workweaver/workmemory-vercel

TypeScript SDK

Full-featured TypeScript SDK with type definitions

Python SDK

Python SDK with async support and pydantic models

LangChain

LangChain integration for AI agents

OpenAI

OpenAI function calling integration

Vercel AI SDK

Vercel AI SDK integration for Next.js apps

Public API

RESTful API for WorkMemory, mission execution, and tenant management. Authenticate with Bearer tokens (format: ww_sk_*).

Base URL

https://api.workweaver.ai/api/v1/public

Authentication

curl -H "Authorization: Bearer ww_sk_your_token_here" \
  https://api.workweaver.ai/api/v1/public/memory/search

Memory Endpoints

GET /memory/search

Search WorkMemory by semantic similarity

POST /memory/add

Add facts and episodes to WorkMemory

GET /memory/recall

Recall recent memories and patterns

DELETE /memory/{id}

Delete specific memory by ID

Execution Endpoints

POST /execute

Execute a workflow or mission

GET /status/{run_id}

Check execution status and results

Example: Search Memory

curl -X POST "https://api.workweaver.ai/api/v1/public/memory/search" \
  -H "Authorization: Bearer ww_sk_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Acme Corp preferred meeting times",
    "limit": 5
  }'

Documentation

See the main documentation for detailed API reference and examples.

Browser Extension

Workweaver browser extension for ChatGPT, Claude, and Gemini. Provides WorkMemory context and execution capabilities directly in your AI chat.

Installation

The browser extension is available for Chrome, Brave, and other Chromium-based browsers.

Features

ChatGPT Integration

Inject WorkMemory context into ChatGPT conversations

Claude Integration

Enhanced Claude conversations with WorkMemory

Gemini Integration

Google Gemini with WorkMemory context

Privacy First

Local processing with encrypted sync

Setup

Install the extension from the Chrome Web Store
Click the extension icon in your browser toolbar
Sign in with your Workweaver account
Enable integrations for ChatGPT, Claude, or Gemini
Start chatting with AI assistants that have WorkMemory context

Permissions

The extension requires:

Read access to active chat pages
Storage permission for local caching
Network permission for Workweaver API calls

Documentation

See the browser extension README for detailed setup instructions.