Tana MCP Server

Implementation Reference

• src/server/tana-mcp-server.ts:172-212 (handler)

  Complete tool definition including registration, input schema (Zod), and handler logic for creating a Tana date node.

  this.server.tool(
    'create_date_node',
    {
      targetNodeId: z.string().optional(),
      date: z.string(),
      description: z.string().optional(),
      supertags: z.array(SupertagSchema).optional()
    },
    async ({ targetNodeId, date, description, supertags }) => {
      try {
        const node: TanaDateNode = {
          dataType: 'date',
          name: date,
          description,
          supertags
        };
  
        const result = await this.tanaClient.createNode(targetNodeId, node);
  
        return {
          content: [
            {
              type: 'text',
              text: JSON.stringify(result, null, 2)
            }
          ],
          isError: false
        };
      } catch (error) {
        return {
          content: [
            {
              type: 'text',
              text: `Error creating date node: ${error instanceof Error ? error.message : String(error)}`
            }
          ],
          isError: true
        };
      }
    }
  );

• src/types/tana-api.ts:30-33 (schema)

  TypeScript interface defining the structure of a TanaDateNode used by the tool handler.

  export interface TanaDateNode extends TanaBaseNode {
    dataType: 'date';
    name: string; // ISO 8601 format
  }

• src/server/tana-mcp-server.ts:21-24 (schema)

  Zod schema for supertags used in the create_date_node input schema.

  const SupertagSchema = z.object({
    id: z.string(),
    fields: z.record(z.string()).optional()
  });

• src/server/tana-mcp-server.ts:749-749 (helper)

  Documentation reference for the tool in the API docs resource.

  - \`create_date_node\`: Create a date node