Access Aident's 1000+ integrations and automation platform from any AI assistant. Works with MCP clients and REST-only agents.
npx skills add aident-ai/aident-skillThis installs the skill definition into your project. Your AI assistant reads it and automatically picks the best mode -- MCP tools if available, REST API otherwise.
Best experience. Your AI assistant gets direct access to 22 tools via the MCP protocol.
Configure your client manually if needed -- see references/mcp.md for all clients (Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, ChatGPT, Gemini CLI, etc.).
Quick setup for Claude Code:
claude mcp add --transport http aident https://app.aident.ai/api/mcpFor agents without MCP support. Same 22 tools, simpler HTTP interface.
- Authenticate via the OOB flow -- tokens are persisted to
~/.aident/credentials.jsonautomatically - POST to
https://app.aident.ai/api/mcp/restwith{ "tool": "...", "arguments": {...} } - See examples/curl/ for ready-to-use examples
Set AIDENT_BASE_URL to point at a different server (default: https://app.aident.ai):
export AIDENT_BASE_URL=https://your-server.example.comSet AIDENT_TOKEN to skip the OOB auth flow and use a token directly:
export AIDENT_TOKEN=your-bearer-tokenBoth are optional. By default, the skill authenticates via the OOB flow and persists tokens to ~/.aident/credentials.json.
| Category | Tools | Examples |
|---|---|---|
| Auth | 2 | Check status, logout / switch accounts |
| Skills & Discovery | 4 | Search skills & integrations, list, inspect, execute |
| Integrations | 2 | Check connected services, connect new ones |
| Playbooks | 6 | Generate, execute, manage automated workflows |
| Templates | 4 | Browse and instantiate pre-built playbooks |
| Dashboard | 4 | Monitor active playbooks and executions |
See SKILL.md for full tool descriptions and dual-mode usage instructions.
MCP clients: OAuth sign-in opens automatically on first use. Tokens are managed by the client.
REST API: On first use, the OOB flow opens a browser for login. Tokens are saved to ~/.aident/credentials.json and reused across sessions. See references/api.md and SKILL.md for the full flow.
Prerequisites: Aident account with connected integrations (Gmail, Slack, GitHub, etc.)
MIT