apx-integrations

Diagnose and guide connection of APX connector plugins for Asana, Google Calendar, GitHub, and Obsidian.

6|1|Updated May 8, 2026
One-click install
npx skills add https://github.com/agentprojectcontext/apx --skill apx-integrations-agentprojectcontext
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: apx-integrations
Source: https://github.com/agentprojectcontext/apx/tree/main/src/core/runtime-skills/apx-integrations
Command: npx skills add https://github.com/agentprojectcontext/apx --skill apx-integrations-agentprojectcontext

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Connector-backed tools in APX fail with errors like "not connected", "read-only", or "not authorized", and the agent cannot fix these itself because connecting a plugin requires human action in the web panel. This Skill teaches the agent to recognize those errors, explain the exact next step to the user, and avoid confusing connectors with MCP servers or the Telegram channel. ## Core Features & Use Cases - Error interpretation: Maps connector tool errors (not connected, OAuth not completed, read-only calendar, missing Asana workspace) to precise user-facing remediation steps in the web panel's Integrations → Plugins section. - Connector catalog knowledge: Covers Asana (token), Google Calendar (user OAuth with write_access and Meet toggles), GitHub (token), Obsidian (local Vault path, the only connector with a CLI via apx obsidian), and WhatsApp (coming_soon, must not be attempted). - Scope resolution: Explains project-vs-default(global) precedence so a connector configured on the default project works everywhere unless overridden. - Use Case: A user asks "why can't you see my calendar?" — the agent recognizes the missing OAuth refresh_token, directs the user to finish the "Connect with Google" step in the panel, and stops instead of retrying the tool in a loop. ## Quick Start Ask the agent to check why the Google Calendar integration is not connected and tell you exactly what to do in the web panel.

Frequently Asked Questions about apx-integrations

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect Google Calendar to an APX agent?▼

Connect Google Calendar through the web panel under Integrations → Plugins, not via CLI. You create a Google Cloud OAuth app, enter the client_id and client_secret, then complete the consent flow so APX stores a refresh_token for the primary calendar.

Why does the calendar tool say not authorized or read-only?▼

Not authorized means the OAuth consent flow was never completed, so no refresh_token exists. Read-only means the write_access toggle is off; enable it in the panel to allow creating events, invites, and Google Meet links.

Is there a CLI command to connect APX integrations?▼

Only Obsidian has a CLI: apx obsidian supports configure, validate, status, sync, and remove over the daemon routes. All other connectors (Asana, Calendar, GitHub) must be connected in the web panel; apx plugins is an unrelated daemon plugin list.

What is the difference between APX connectors and MCP servers?▼

Connectors are stored per-project connections to services like Asana or Google Calendar that back specific agent tools. MCP servers are a separate mechanism handled by the apx-mcp skill; registering an MCP server is not done through the Integrations panel.

Can I use the WhatsApp integration in APX?▼

The WhatsApp connector is marked coming_soon and must not be attempted, since it needs a QR-pairing bridge APX does not ship. However, the separate WhatsApp channel already delivers incoming messages to the super-agent and works.

How does integration scope work across APX projects?▼

Each project resolves its own enabled integration record first; if none exists, it inherits the record from the default project. Configuring a connector once on the default project makes it available to every project that has not overridden it.