Query

Query the Autographical activity stream and knowledge graph.

Components:

• Skills
  Prescribed commands that the user or agent can invoke to query Autographical.

• MCP
  Tools to query the real time activity stream and traverse the knowledge graph.

• Plugin
  Bundles the MCP server definition and skills together.

Plugin

Installation

/plugin marketplace add autographical/claude-code-plugins
/plugin install autographical@autographical

MCP Authentication

The plugin includes an MCP definition. After installation, authenticate with the Autographical MCP server.

Interactive (default)

Authentication is handled automatically via OAuth. After installing the plugin, open the MCP panel and authenticate:

/mcp

Claude Code will open your browser to sign in to Autographical. Tokens are managed by Claude Code directly (stored securely in your system keychain and refreshed automatically).

Headless (remote agents, CI, scheduled tasks)

For non-interactive environments where OAuth isn’t available, configure the MCP server directly with an API key:

claude mcp add --transport http autographical https://api.autographical.ai/mcp \
  --header "Authorization: Bearer ${AUTOGRAPHICAL_API_KEY}"

Create an API key in your Autographical user settings .

Configuration

MCP URL

Defaults to Autographical Cloud US data region (https://api.autographical.ai/mcp). Override with:

• AUTOGRAPHICAL_MCP_URL environment variable

Skills

Prescribed commands that the user or agent can invoke:

• /whats-up — fetch recent activity and bring context into the session
• /whats-next — suggest what to work on next based on activity and current working context

For full skill documentation, see Agent Skills.

MCP

Tools to query the real time activity stream and traverse the knowledge graph:

• recent_activity — sessions and top resources from the last 48 hours
• search — hybrid search across resources, sessions, and activity
• get_resource — detailed info about a specific resource
• get_resource_content — extracted text content of a resource
• get_session — full session details with resources and interactions

For full tool documentation, see MCP.

Installation

Via /plugin

The tools are bundled with the autographical plugin. No additional setup needed — install the plugin and authenticate (see Plugin above).

Via mcp add

To add the MCP server without the plugin (e.g. if you only want tools, not skills):

claude mcp add --transport http autographical https://api.autographical.ai/mcp

Authentication

Interactive (default)

Authentication is handled automatically via OAuth. After installing the plugin, open the MCP panel and authenticate:

/mcp

Claude Code will open your browser to sign in to Autographical. Tokens are managed by Claude Code directly (stored securely in your system keychain and refreshed automatically).

Headless (remote agents, CI, scheduled tasks)

For non-interactive environments where OAuth isn’t available, configure the MCP server directly with an API key:

claude mcp add --transport http autographical https://api.autographical.ai/mcp \
  --header "Authorization: Bearer ${AUTOGRAPHICAL_API_KEY}"

Create an API key in your Autographical user settings .