Ninetn

The Ninetn MCP Server exposes a lightweight interface you can use with MCP clients to manage memos in Ninetn’s AI-powered memo system. It enables AI-assisted memo creation, retrieval, and search, letting you create memos that require approval, fetch specific memos, list memos by channel with pagination, and search by content.

How to use

You connect your MCP client to the Ninetn MCP Server to perform actions against your memos. Use the available MCP endpoints to create memos that need approval, retrieve memos by ID, list memos from a channel (with paging), and search memos by keywords or content. Run natural language prompts in your client to trigger these actions, such as asking the server to create a memo, list recent memos, or search for specific terms.

How to install

Prerequisites you need before installation are Node.js and npm, and you should have the Ninetn memo application running locally (default http://localhost:50019). Install and build the MCP server package, then configure your MCP client to connect to the server.

Step-by-step commands you will run on your machine:

npm install
npm run build

Configure your MCP client with an MCP server entry that points to the Ninetn MCP Server. The example below shows how to enable a local stdio connection via npx, and a separate HTTP connection you can use if you prefer a direct URL.

{
  "mcpServers": {
    "ninetn_http": {
      "type": "http",
      "name": "ninetn_http",
      "url": "http://localhost:50019",
      "args": []
    },
    "ninetn_stdio": {
      "type": "stdio",
      "name": "ninetn_stdio",
      "command": "npx",
      "args": ["-y", "ninetn-mcp-server"],
      "env": [
        {"name": "NINETN_API_URL", "value": "http://localhost:50019"}
      ]
    }
  }
}

Additional sections

Notes about usage and configuration: you can choose either the HTTP connection or the local stdio connection based on your environment and tooling. The default API URL for the Ninetn server is http://localhost:50019. If you run the server on a different URL, update NINETN_API_URL in environment variables accordingly.

Development and testing: to verify tool functionality, you can run the project’s test suite once you have dependencies installed. Typical commands include build, run tests, and optional development with a watch mode if supported by your setup.

Available tools

memo_create

Create a new memo that requires 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.