# Ogment

> Invoke MCP tools via Ogment CLI — secure access to Linear, Notion, Gmail, PostHog, and 100+ SaaS integrations through Ogment's governance layer.

- Skill: `dvcrn/ogment` (Agent Skill)
- Install (CLI): `npx skillmds@latest add dvcrn/ogment`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/ogment/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/ogment

---


# Ogment CLI Skill

Securely invoke MCP tools via the Ogment CLI. Access your connected SaaS tools (Linear, Notion, Gmail, Slack, Supabase, etc.) through Ogment's governance layer.

## Quick Start

### Step 1: Check Auth
```bash
ogment auth status
```
- If `loggedIn: true` → skip to Step 3
- If `loggedIn: false` → continue to Step 2

### Step 2: Login (if needed)
```bash
ogment auth login
```

Extract `verificationUri` from the response and **send it to your human as a clickable link:**

> **🔐 Approve Ogment access:**
> 👉 [Click to approve](https://dashboard.ogment.ai/cli/approve?authRequestId=...)

Wait for approval, then verify with `ogment auth status`.

### Step 3: Discover What's Available
```bash
ogment catalog
ogment catalog <serverId>
```

### Step 4: Summarize to Your Human
> **✅ Connected to Ogment!** Here's what I can access:
> - **Gmail:** 11 tools (messages, threads, drafts)
> - **Notion:** 5 tools (search, fetch, comments)
> - **Slack:** 7 tools (conversations, users)
>
> What would you like me to help with?

## Core Workflow

```
auth status → catalog → catalog <server> → invoke <server> <tool>
```

### Discover servers
```bash
ogment catalog
```

### List tools
```bash
ogment catalog <serverId>
```

### Inspect tool schema
```bash
ogment catalog <serverId> <toolName>
```

### Invoke a tool
```bash
ogment invoke <serverId> <toolName> --input '<json>'
```

## Common Patterns

### Gmail (requires `userId: "me"`)
```bash
ogment invoke <server> gmail_listMessages --input '{"userId": "me", "maxResults": 10}'
ogment invoke <server> gmail_getMessage --input '{"userId": "me", "messageId": "<id>"}'
```

### Notion
```bash
ogment invoke <server> Notion_notion-search --input '{"query": "quarterly review"}'
```

### Supabase
```bash
ogment invoke <server> Supabase_execute_sql --input '{"query": "SELECT * FROM users LIMIT 5"}'
```

### Linear
```bash
ogment invoke <server> Linear_list_issues --input '{}'
```