diatonic-codes/ninetn-mcp-server

Ninetn MCP Server

MCP (Model Context Protocol) server for integrating with Ninetn - an AI-powered memo application.

This server provides MCP clients with tools to interact with Ninetn's memo system, enabling AI-assisted memo creation, retrieval, and search functionality.

Prerequisites

• Ninetn application must be running on your local machine (default: http://localhost:50019)
• Node.js and npm

Available Tools

• memo_create - Create new memos that require user approval before being saved
• memo_get - Retrieve a specific memo by its ID
• memo_list - List memos from a channel with pagination support
• memo_search - Search memos by content with filtering options

Quick Start

Note: This package will be published to npm in the future for easier installation.

Currently, to use this MCP server:

1. Build the MCP server:

npm install
npm run build

2. Configure your MCP client:

Example for Claude Code - create .mcp.json:

{
  "mcpServers": {
    "ninetn": {
      "command": "npx",
      "args": ["-y", "ninetn-mcp-server"],
    }
  }
}

Note: Add "env": {"NINETN_API_URL": "http://your-custom-url"} only if your Ninetn server is not running on the default http://localhost:50019.

For other MCP clients, refer to their specific configuration documentation.

3. Start your MCP client and use natural language:

"Create a memo about today's meeting"
"List recent memos from this channel"
"Search for memos containing 'project updates'"

Development

# Install dependencies
npm install

# Build
npm run build

# Development with watch mode
npm run dev

# Format code
npm run format

# Lint
npm run lint

# Test
npm run test

Testing

Test all tools functionality:

npm run test:all-tools

License

MIT