Granola MCP Server

Instructions

Implementation Reference

• src/index.ts:456-480 (handler)

  Handler for the 'list_granola_documents' tool. Retrieves all documents using apiClient.getAllDocuments(), limits them, and returns JSON with id, title, created_at, updated_at.

  case "list_granola_documents": {
    const limit = (args?.limit as number) || 50;
    const allDocs = await apiClient.getAllDocuments();
    const docs = allDocs.slice(0, limit);
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(
            {
              count: docs.length,
              documents: docs.map((doc) => ({
                id: doc.id,
                title: doc.title || "Untitled",
                created_at: doc.created_at,
                updated_at: doc.updated_at,
              })),
            },
            null,
            2
          ),
        },
      ],
    };
  }

• src/index.ts:136-150 (registration)

  Tool registration in the tools array, including name, description, and inputSchema.

    {
      name: "list_granola_documents",
      description: "List all Granola documents with basic metadata.",
      inputSchema: {
        type: "object",
        properties: {
          limit: {
            type: "number",
            description: "Maximum number of documents to return (default: 50)",
            default: 50,
          },
        },
      },
    },
  ];

• src/granola-api.ts:105-123 (helper)

  Helper method getAllDocuments() in GranolaApiClient that paginates and fetches all Granola documents from the API using fetchDocuments.

  async getAllDocuments(): Promise<GranolaDocument[]> {
    const allDocs: GranolaDocument[] = [];
    let offset = 0;
    const limit = 100;
  
    while (true) {
      const docs = await this.fetchDocuments(limit, offset);
      if (docs.length === 0) {
        break;
      }
      allDocs.push(...docs);
      offset += limit;
      if (offset > 10000) {
        break;
      }
    }
  
    return allDocs;
  }