IMA MCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
IMA MCP
A self-hosted MCP bridge for IMA notes and knowledge bases, based on ima-mcp-server under the MIT license.
Source: W-World-Labs/ima-mcp.
The bridge supports searching and browsing knowledge bases, reading and writing notes, importing URLs, uploading Base64 files up to 6 MiB, and direct calls to the IMA note/wiki OpenAPI. Operations use the permissions of your own IMA API credentials. File uploads have been schema-checked; they have not been verified with a real user file.
Run from source
Use Node.js 22 or newer for development and CI. The runtime supports Node.js 18 or newer.
npm ci --ignore-scripts
npm run checkObtain your own API credentials from the IMA agent interface. Supply IMA_CLIENT_ID, IMA_API_KEY and IMA_MCP_KEY through your process manager or a private environment file. The server does not load .env files itself. Generate a separate MCP access key with:
node -e "console.log(require('node:crypto').randomBytes(32).toString('base64url'))"Once the variables are set, run npm start. The server binds to 127.0.0.1:18448 and exposes Streamable HTTP at http://127.0.0.1:18448/mcp/<your-access-key>. It does not provide a stdio transport. Configure your MCP client to use that URL. The access key must be at least 40 characters and contain only letters, digits, _ or -.
Variable | Purpose |
| Your IMA OpenAPI client ID |
| Your IMA OpenAPI API key |
| Independent access key protecting this MCP endpoint |
For compatibility, IMA_OPENAPI_CLIENTID and IMA_OPENAPI_APIKEY are accepted when their primary variables are absent. The final credential fallback reads ~/.config/ima/client_id and ~/.config/ima/api_key.
For remote clients, put the loopback service behind your own authenticated HTTPS ingress. Keep access logs from recording the full MCP path: it contains the access key. The deploy/ units are optional Linux examples; adapt their paths and account locally. The optional tunnel unit requires a separately installed tunnel client and private tunnel configuration. No tunnel binary, credentials or production configuration are included.
Related MCP server: Sensefold MCP server
Build and release
GitHub Actions runs locked dependency installation with lifecycle scripts disabled, syntax checks and package inventory validation on pull requests and pushes. A v<package-version> tag on main additionally publishes the npm archive and its SHA-256 checksum as a GitHub Release. The workflow does not publish to npm or deploy a running server.
npm pack --ignore-scriptsThe npm package contains only server.mjs, package.json, this README and LICENSE. Use a source checkout and package-lock.json for locked installation with npm ci.
License
MIT. The upstream project's attribution is preserved in LICENSE.
Third-party code and dependencies
This project is based on xuewolai/ima-mcp-server; its MIT attribution is retained in LICENSE. The direct runtime dependency is @modelcontextprotocol/sdk; package.json and package-lock.json record the declared and locked dependency graph. Dependencies retain their own licenses. IMA is a separately operated service and is not included in this package. Review the upstream and dependency license texts when redistributing.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Maintained, agent-readable knowledge bases with calibrated search and provenance. Pro key adds XL.
Governed, auditable knowledge your team curates for its AI assistants, self-hostable
Your knowledge, agents and apps on a node you own, reached from the AI you already use.
Shared knowledge base for AI agents. Semantic search across agents, no setup required — just a URL.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables Agents to retrieve structured evidence with spans, versions, and content hashes from a self-hosted knowledge base, and optionally delegate single-shot questions. Exposes read-only search, evidence lookup, and answer tools over Streamable HTTP with Bearer authentication.MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI clients like Claude, ChatGPT, and Cursor to search, read, and write back to one cross-model Markdown library of saved articles, videos, PDFs, notes, and conversations. Hosted remote server with OAuth 2.1 or Agent-key auth and read_only, edit, or full permission tiers.MIT
- AlicenseNot gradedqualityBmaintenanceExposes a remote Streamable HTTP MCP endpoint that lets an AI client save, search, and retrieve structured memories, archived conversations, social-account notes, and knowledge documents. Access is scoped by per-client API keys with configurable read/write permission levels, collections, and operations.ISC
- FlicenseNot gradedqualityAmaintenanceGives AI agents access to a persistent document workspace so they can search, read, and update knowledge through 22 focused tools, 2 prompts, and 3 resources, with batch actions and direct workspace-item inspection. Runs either as a hosted Streamable HTTP endpoint with OAuth or API keys, or as a self-hosted stdio bridge pointed at your own instance.-