n8n_list_credentials

Retrieve a list of stored credentials from n8n workflows, showing names and types while excluding sensitive data for security.

Instructions

List all credentials (without sensitive data).

Args:

type (string, optional): Filter by credential type (e.g., "slackApi", "httpBasicAuth")
limit (number): Maximum results (default: 100)
cursor (string, optional): Pagination cursor

Returns: List of credentials with id, name, type, and timestamps. ⚠️ Credential data/secrets are NOT included for security.

Input Schema

TableJSON Schema

Name	Required	Description
`type`	No	Filter by credential type
`limit`	No	Maximum results to return
`cursor`	No	Pagination cursor

Implementation Reference

src/tools/credentials.ts:50-73 (handler)

The handler logic for n8n_list_credentials. It fetches credentials from the API based on provided optional filters and formats the response for the user.

async (params: z.infer<typeof ListCredentialsSchema>) => {
  const queryParams: Record<string, unknown> = { limit: params.limit };
  if (params.type) queryParams.type = params.type;
  if (params.cursor) queryParams.cursor = params.cursor;
  
  const response = await get<N8nPaginatedResponse<N8nCredentialListItem>>('/credentials', queryParams);
  
  const formatted = response.data.map(formatCredential).join('\n\n---\n\n');
  const output = {
    count: response.data.length,
    credentials: response.data,
    nextCursor: response.nextCursor
  };
  
  let text = `Found ${response.data.length} credential(s):\n\n${formatted}`;
  if (response.nextCursor) {
    text += `\n\n_More results available. Use cursor: ${response.nextCursor}_`;
  }
  
  return {
    content: [{ type: 'text', text }],
    structuredContent: output
  };
}

src/tools/credentials.ts:28-49 (registration)

Registration of the 'n8n_list_credentials' tool in the MCP server.

  server.registerTool(
    'n8n_list_credentials',
    {
      title: 'List n8n Credentials',
      description: `List all credentials (without sensitive data).

Args:
  - type (string, optional): Filter by credential type (e.g., "slackApi", "httpBasicAuth")
  - limit (number): Maximum results (default: 100)
  - cursor (string, optional): Pagination cursor

Returns:
  List of credentials with id, name, type, and timestamps.
  ⚠️ Credential data/secrets are NOT included for security.`,
      inputSchema: ListCredentialsSchema,
      annotations: {
        readOnlyHint: true,
        destructiveHint: false,
        idempotentHint: true,
        openWorldHint: false
      }
    },

n8n MCP Server