diary-mcp

jaey-p/diary-mcp

3.2

If you are the rightful owner of diary-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Model Context Protocol (MCP) server is a versatile tool designed to facilitate seamless communication between clients and servers using the MCP framework. It is particularly useful for integrating AI models and tools into various applications.

Superthread MCP Server

An unofficial Model Context Protocol (MCP) server for integrating with the Superthread API. This server provides tools for managing users, cards, projects, and boards in Superthread through Claude and other MCP-compatible clients.

Available tools

User management

  • get_me - Get information about the current user.
  • update_me - Update information about the current user.
  • get_team_members - Get information about team members.

Card management

  • create_card - Create a new card.
  • get_card - Get information about a card.
  • get_assigned_cards - Get cards assigned to a user.
  • update_card - Update information about a card.
  • delete_card - Delete a card.
  • archive_card - Archive a card.

Project management

  • create_project - Create a new project.
  • get_project - Get information about a project.
  • list_projects - List projects.
  • update_project - Update information about a project.
  • delete_project - Delete a project.
  • archive_project - Archive a project.

Pages

  • create_page - Create a new page.
  • get_page - Get information about a page.
  • list_pages - List pages.
  • update_page - Update information about a page.
  • delete_page - Delete a page.
  • archive_page - Archive a page.

Comments

  • create_comment - Create a new comment.
  • get_comment - Get information about a comment.
  • get_replies - Get replies to a comment.
  • reply_to_comment - Reply to a comment.
  • edit_comment - Edit a comment.
  • edit_reply - Edit a reply.
  • delete_comment - Delete a comment.
  • delete_reply - Delete a reply.

Board management

  • create_board - Create a new board.
  • get_board - Get information about a board.
  • list_boards - List boards.
  • update_board - Update information about a board.
  • delete_board - Delete a board.
  • archive_board - Archive a board.
  • create_status - Create a new status.
  • update_status - Update information about a status.

Spaces management

  • create_space - Create a new space.
  • get_space - Get information about a space.
  • list_spaces - List spaces.
  • update_space - Update information about a space.
  • delete_space - Delete a space.

MCP Client Integration

To use this server with Claude or another MCP client, configure it to connect to:

http://localhost:3000/mcp

Include your Superthread Personal Access Token in the Authorization header:

Authorization: Bearer YOUR_SUPERTHREAD_TOKEN

Development

Scripts

  • bun run dev - Run in development mode
  • bun run build - Build for production
  • bun run start - Build and run
  • bun run test - Run health check test

Project Structure

src/
ā”œā”€ā”€ lib/           # Core utilities (API client, search)
ā”œā”€ā”€ tools/         # MCP tool implementations
ā”œā”€ā”€ types/         # TypeScript type definitions
ā””ā”€ā”€ server.ts      # MCP server setup

Docker Support

A Dockerfile is included for containerized deployment:

docker build -t superthread-mcp .
docker run -p 3000:3000 superthread-mcp

Requirements

  • Node.js 22+ or Bun runtime
  • Superthread Personal Access Token
  • Network access to api.superthread.com

License

This is an unofficial integration and is not affiliated with Superthread.