AFFiNE MCP Server

Instructions

Implementation Reference

• src/tools/accessTokens.ts:36-40 (handler)

  The asynchronous handler function that executes the tool logic by sending a GraphQL mutation to generate a new personal access token.

  const generateAccessTokenHandler = async (parsed: { name: string; expiresAt?: string }) => {
    const mutation = `mutation($input: GenerateAccessTokenInput!){ generateUserAccessToken(input:$input){ id name createdAt expiresAt token } }`;
    const data = await gql.request<{ generateUserAccessToken: any }>(mutation, { input: { name: parsed.name, expiresAt: parsed.expiresAt ?? null } });
    return text(data.generateUserAccessToken);
  };

• src/tools/accessTokens.ts:41-52 (registration)

  Registers the 'affine_generate_access_token' tool with the MCP server, providing title, description, input schema using Zod, and references the handler function.

  server.registerTool(
    "affine_generate_access_token",
    {
      title: "Generate Access Token",
      description: "Generate a personal access token (returns token).",
      inputSchema: {
        name: z.string(),
        expiresAt: z.string().optional()
      }
    },
    generateAccessTokenHandler as any
  );

• src/index.ts:72-72 (registration)

  Top-level call to registerAccessTokenTools, which includes the registration of 'affine_generate_access_token' among other access token tools.

  registerAccessTokenTools(server, gql);

• src/tools/accessTokens.ts:47-49 (schema)

  Zod-based input schema for the tool: requires 'name' string, optional 'expiresAt' string.

    name: z.string(),
    expiresAt: z.string().optional()
  }