Fortnox MCP Server

A Model Context Protocol (MCP) server for exploring Fortnox API documentation. Provides 377 Fortnox API endpoints documentation from the official OpenAPI specification.

Overview

• Documentation-only server - provides API endpoint information, doesn't make API calls
• 377 Fortnox API endpoints from official OpenAPI 3.0 spec
• 7 MCP tools for exploring API documentation
• No authentication required - pure documentation browsing
• AI-optimized responses with structured markdown formatting

Installation

npm install -g fortnox-doc-mcp

Or use with npx:

npx fortnox-doc-mcp

Available Tools

1. get_api_overview - Get API overview, statistics, and recommended workflow
2. list_all_endpoints - Browse all Fortnox API endpoints (with optional filters)
3. get_endpoint_details - Get full documentation for a specific endpoint
4. get_endpoints_by_resource - Get all endpoints for a resource grouped by operation
5. search_endpoints - Search endpoints by keyword
6. list_resource_groups - List all 81 API resource categories
7. get_schema_details - View data model schemas

Quick Start

For Claude Desktop

Add to your Claude Desktop config file:

Windows: %APPDATA%\Claude\claude_desktop_config.json
Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "fortnox-docs": {
      "command": "npx",
      "args": ["-y", "fortnox-doc-mcp"]
    }
  }
}

Restart Claude Desktop to access the tools.

For Other MCP Clients

{
  "servers": {
    "fortnox-doc-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "fortnox-doc-mcp"]
    }
  }
}

Usage Examples

Once configured, you can ask AI assistants:

• "Give me an overview of the Fortnox API" → Uses get_api_overview
• "List all Fortnox customer endpoints" → Uses get_endpoints_by_resource
• "Show me details for GET /3/customers" → Uses get_endpoint_details
• "Search for invoice endpoints" → Uses search_endpoints
• "What resource groups are available?" → Uses list_resource_groups
• "Show me the Customer schema" → Uses get_schema_details

Development

From Source

# Clone repository
git clone https://github.com/yourusername/fortnox-doc-mcp.git
cd fortnox-doc-mcp

# Install dependencies
npm install

# Build
npm run build

# Test
npm test

Project Structure

fortnox-doc-mcp/
├── src/
│   ├── index.ts              # MCP server with 7 tools
│   ├── openapi-parser.ts     # OpenAPI spec parser
│   └── test-docs.ts          # Documentation test
├── openapi (1).json          # Fortnox OpenAPI specification
└── dist/                     # Compiled JavaScript

Technical Details

• OpenAPI Version: 3.0.3
• Endpoints: 377 Fortnox API endpoints
• Resource Groups: 81 categories
• Loading: Singleton pattern (loaded once into memory)
• Performance: O(1) endpoint lookups, no external API calls
• Node Version: 18+

FAQ

Q: Do I need a Fortnox API token?
A: No! This is a documentation server. No API credentials required.

Q: Can this make API calls to Fortnox?
A: No. It only provides documentation about endpoints from the OpenAPI spec.

Q: How do I use this with Claude Desktop?
A: Add the configuration to claude_desktop_config.json and restart Claude Desktop.

Q: Can I use this to build a Fortnox integration?
A: Yes! Use this to explore API documentation, understand endpoints, parameters, and schemas before building your integration.

License

MIT

Links

• Fortnox API Documentation
• Model Context Protocol
• GitHub Repository